SSD Nodes Learn Hosting plans →
Guide Matt ConnorDi Matt Connor

Mealie su VPS: installazione con Docker Compose

Installa Mealie su un VPS con Docker Compose: importa ricette da un link, crea piani pasti e liste della spesa, configura nginx, TLS e backup.

Cosa fa un gestore di ricette self-hosted

Un gestore di ricette self-hosted conserva le ricette in un database su un server di tua proprietà e Mealie è la soluzione scelta dalla maggior parte delle famiglie. Incolli l'indirizzo di una pagina di ricette e Mealie ne legge ingredienti, passaggi, quantità e tempo di cottura, ignorando il testo descrittivo e la pubblicità. Nella tua raccolta finisce solo la ricetta.

Il resto dell'applicazione è essenziale. Puoi trascinare le ricette in un piano settimanale dei pasti e generare una lista della spesa a partire da quel piano. Ogni persona che cucina ha il proprio account. L'intera applicazione viene eseguita in un unico container e resta inattiva tra una richiesta e l'altra, quindi un VPS di dimensioni contenute la gestisce senza problemi.

Questa guida usa Docker Compose. Se i termini services: e volumes: non ti sono familiari, leggi prima come sono strutturati i file Docker Compose, perché tutto ciò che segue consiste in un unico file Compose e quattro comandi.

Installare Mealie con Docker Compose

Mealie pubblica le proprie immagini nel registro dei container di GitHub. Al 18 novembre 2026, il tag stabile corrente è v3.31.0, rilasciato il 13 novembre. Questa versione include correzioni di sicurezza e il progetto raccomanda a tutti di aggiornare. Bloccare una versione invece di usare latest: con latest, un docker compose pull in un giorno qualsiasi può portare il sistema a una migrazione del database per cui non si era preparati.

sudo mkdir -p /srv/mealie
cd /srv/mealie
sudo nano docker-compose.yml
services:
  mealie:
    image: ghcr.io/mealie-recipes/mealie:v3.31.0
    container_name: mealie
    restart: always
    ports:
      - "127.0.0.1:9925:9000"
    deploy:
      resources:
        limits:
          memory: 1000M
    volumes:
      - mealie-data:/app/data/
    environment:
      ALLOW_SIGNUP: "false"
      PUID: 1000
      PGID: 1000
      TZ: Europe/Amsterdam
      BASE_URL: https://recipes.example.com

volumes:
  mealie-data:

Prima di avviarlo, occorre controllare due righe.

La porta è indicata come 127.0.0.1:9925:9000 e non come 9925:9000. Il container è in ascolto sulla porta 9000 internamente, mentre l'host associa la porta 9925 a quella porta. Associando il mapping all'indirizzo di loopback, nginx può raggiungere Mealie, ma Internet no. Docker scrive le proprie regole nel packet filter, quindi un semplice 9925:9000 è raggiungibile dall'esterno anche quando il firewall indica la porta come chiusa. È importante capire una volta questo comportamento: vedere perché le porte pubblicate da Docker ignorano ufw.

BASE_URL deve essere l'indirizzo pubblico esatto che si userà, con lo schema e senza slash finale. Mealie usa questo valore per creare i link di reimpostazione della password e di invito. Impostandolo a http://localhost:9925, l'invito inviato al partner conterrà un link funzionante soltanto sul server stesso.

Avviarlo e monitorare il primo boot.

sudo docker compose up -d
sudo docker compose logs -f mealie

Il primo avvio crea il database SQLite ed esegue le migrazioni. L'operazione richiede alcuni secondi. Quando il log si stabilizza e non stampa più righe sulle migrazioni, verificare localmente l'applicazione.

curl -I http://127.0.0.1:9925

Un 200 OK indica che l'applicazione è attiva. Se si riceve Connection refused, eseguire sudo docker compose ps -a per verificare lo stato e il codice di uscita del container. Un container terminato con il codice 137 ha ricevuto SIGKILL; questo codice, da solo, non dimostra che abbia superato il limite di memoria di 1000M. Anche l'arresto manuale del container produce lo stesso codice.

Primo accesso e disattivazione della registrazione aperta

L'account predefinito è changeme@example.com e la password è MyPassword. Accedi con queste credenziali e cambiale subito, perché questa combinazione è riportata nella documentazione ed è quindi inclusa in ogni scanner.

ALLOW_SIGNUP: "false" nel file compose è impostato deliberatamente. Con la registrazione aperta, chiunque trovi l'indirizzo può creare un account nel tuo archivio di ricette. Quando la registrazione è chiusa, aggiungi gli utenti dall'area di amministrazione, che genera un link di invito da inviare personalmente. Il link viene creato a partire da BASE_URL, quindi questo valore è importante. Se in seguito esegui più applicazioni sullo stesso server e vuoi usare una sola password per tutte, Mealie può delegare l'autenticazione a un provider di identità esterno, ad esempio un'istanza Authentik self-hosted.

Mealie assegna gli utenti a un nucleo familiare e i nuclei familiari appartengono a un gruppo. Tutti gli utenti dello stesso nucleo familiare condividono il piano dei pasti e la lista della spesa, come accade normalmente in una famiglia. La raccolta di ricette è più ampia: i nuclei familiari condividono ricette, tag e categorie con tutti gli altri nuclei familiari dello stesso gruppo. Nuclei familiari distinti sullo stesso server mantengono quindi piani e liste separati, ma possono usare le stesse ricette. Questo modello è adatto anche a un appartamento condiviso in cui nessuno concorda sulle acciughe. Se servono raccolte completamente separate, assegna gli utenti a gruppi distinti, perché tra gruppi non viene condiviso nulla.

L’importatore, il motivo per cui eseguire questa procedura

Apri la raccolta di ricette, scegli di creare una ricetta da un URL e incolla un link. Mealie scarica la pagina e cerca i dati strutturati della ricetta, cioè il blocco leggibile dalle macchine che la maggior parte dei siti di ricette incorpora per i motori di ricerca. Quando il blocco è presente, l’importazione è pulita e immediata.

Se configuri un provider AI, puoi importare anche da un’immagine o dal testo semplice che incolli, ad esempio la fotografia di una pagina di un libro di cucina. L’importazione da immagine richiede un provider in grado di leggere le immagini. Senza un provider, queste importazioni non sono disponibili. Seguono un percorso più lento e richiedono una verifica successiva, perché una frazione scritta a mano può essere interpretata facilmente in modo errato.

Le importazioni in blocco vengono eseguite dalla stessa schermata: incolla un elenco di indirizzi, uno per riga, e Mealie li elabora in background. Una raccolta di duecento segnalibri viene trasferita in un’unica sessione.

Piani dei pasti e lista della spesa

Il pianificatore dei pasti è un calendario. Trascina una ricetta su un giorno per pianificarla. Aggiungi le ricette pianificate a una lista della spesa per raccoglierne gli ingredienti. Per combinare i duplicati, inserisci prima Alimenti e Unità in Gestisci dati, abilita le quantità degli ingredienti per ogni ricetta e analizza gli ingredienti associandoli a quegli alimenti e a quelle unità. In questo modo, se due ricette richiedono cipolle, nella lista viene visualizzata una sola voce invece di due.

La lista è una pagina aggiornata in tempo reale, che puoi consultare dal telefono mentre fai la spesa. Poiché è archiviata sul tuo server, tutte le persone della famiglia visualizzano la stessa lista nello stesso momento. Quando una persona spunta il latte, questo viene rimosso anche dallo schermo dell'altra persona.

Configurare nginx e TLS davanti all'applicazione

In questa configurazione Mealie usa HTTP in chiaro; supporta anche TLS tramite TLS_CERTIFICATE_PATH e TLS_PRIVATE_KEY_PATH. Termina TLS in nginx, configurato davanti a Mealie. Prima punta un record DNS A al server, perché la procedura di emissione del certificato verifica quel nome.

sudo apt update && sudo apt install -y nginx
sudo nano /etc/nginx/sites-available/mealie
server {
    listen 80;
    server_name recipes.example.com;

    client_max_body_size 64M;

    location / {
        proxy_pass http://127.0.0.1:9925;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}
sudo ln -s /etc/nginx/sites-available/mealie /etc/nginx/sites-enabled/
sudo nginx -t && sudo systemctl reload nginx

L'output di nginx -t, che stampa syntax is ok e test is successful, è il controllo decisivo. Esegui il reload solo dopo che il controllo è riuscito, perché il reload di una configurazione non valida lascia in esecuzione quella precedente e nasconde l'errore fino al riavvio successivo.

client_max_body_size 64M è necessario perché il valore predefinito di nginx è 1 MB. Il caricamento della foto di una ricetta o il ripristino di un backup tramite browser invia un body più grande. Senza questa direttiva, nginx restituisce 413 Request Entity Too Large, non Mealie, quindi nei log dell'applicazione non compare alcun messaggio.

Quindi emetti il certificato. La procedura e il relativo timer di rinnovo sono descritti in emissione di un certificato Let's Encrypt per nginx con certbot.

sudo apt install -y certbot python3-certbot-nginx
sudo certbot --nginx -d recipes.example.com

Certbot modifica il server block per metterlo in ascolto sulla porta 443 e aggiunge un redirect dalla porta 80. Apri il sito tramite https:// e verifica che il browser accetti il certificato. Se Mealie viene caricato, ma i relativi link reindirizzano a http://, allora BASE_URL contiene ancora http. Correggi il valore, quindi esegui sudo docker compose up -d per ricreare il container con il nuovo valore.

La pubblicazione di Mealie in un sottopercorso, ad esempio example.com/recipes, non funziona, perché il frontend non può essere pubblicato da un sottopercorso. Usa un sottodominio.

Backup e comportamento effettivo di un ripristino

Tutti i dati gestiti da Mealie si trovano in /app/data/ all'interno del container, cioè nel volume mealie-data. Copiando questo volume si copiano insieme ricette, immagini e database. La documentazione di Mealie indica l'arresto del container e la copia di questa directory come il metodo migliore per eseguire il backup di un'installazione SQLite.

sudo docker volume ls
sudo docker compose stop mealie
sudo docker run --rm -v mealie_mealie-data:/data -v "$PWD":/backup \
  alpine tar czf /backup/mealie-data.tgz -C /data .
sudo docker compose start mealie

Il nome del volume include il nome del progetto come prefisso, mentre il nome del progetto corrisponde alla directory che contiene il file compose. Da /srv/mealie, il volume è mealie_mealie-data. Per questo il primo comando è docker volume ls: usare il nome visualizzato dal comando, non quello riportato in questa guida. È importante arrestare prima il container, perché SQLite si trova abbastanza spesso nel mezzo di una scrittura e una copia a caldo può essere ripristinata in modo illeggibile.

Mealie dispone anche di una propria pagina di backup nell'area amministrativa, che scrive un archivio zip contenente il database come database.json. Un archivio può essere ripristinato in un'istanza che esegue la stessa versione o una versione più recente di Mealie. Per spostare l'installazione tra server, eseguire la stessa versione bloccata sul nuovo server durante la copia del volume, oppure ripristinare l'archivio nella stessa versione o in una versione più recente. Il ripristino è distruttivo per progettazione: elimina il database corrente prima di caricare l'archivio e non può essere annullato. Al termine, la sessione viene disconnessa.

Nessuna delle due copie costituisce un backup finché rimane sullo stesso server. Trasferire periodicamente l'archivio in un'altra posizione. È questo lo scopo di backup cifrati fuori dal server con restic.

Aggiornamento di Mealie

cd /srv/mealie
sudo nano docker-compose.yml
sudo docker compose pull
sudo docker compose up -d
sudo docker compose logs -f mealie

Aumenta la versione fissata nel file, quindi esegui il pull e ricrea il container. Le migrazioni vengono eseguite al primo avvio della nuova immagine. Crea una copia del volume prima di passare a una nuova versione principale, perché una migrazione interrotta a metà può lasciare un database che l'immagine precedente non riesce più ad aprire. Leggi le note di rilascio relative a tutte le versioni comprese tra quella attuale e la nuova.

Quando l'importazione non riesce

Alcuni siti non pubblicano alcun dato strutturato sulle ricette e Mealie importa quindi il titolo con un elenco degli ingredienti vuoto. Senza un provider AI non è possibile risolvere il problema tramite configurazione, quindi inserisci manualmente il testo della ricetta. Se hai configurato un provider, quando lo scraper non trova nulla Mealie invia al modello il contenuto della pagina. Anche in questo caso devi verificare il risultato confrontandolo con l'originale, come per qualsiasi altra importazione AI.

Altri errori dipendono dalla protezione anti-bot presente davanti al sito della ricetta, che risponde a Mealie con una pagina di verifica invece della ricetta. Mealie simula già il comportamento di un browser e ruota il proprio user agent per ridurre questo problema. Se un sito continua a rifiutare le richieste, le opzioni documentate consistono nell'inviare lo scraper attraverso un proxy con una reputazione dell'indirizzo migliore oppure nell'eseguire un'istanza di FlareSolverr che risolva la verifica in un browser reale. Entrambe le opzioni sono facoltative e si configurano tramite variabili d'ambiente del container.

Un'importazione che non riesce perché il server non può raggiungere il sito è un problema diverso. Esegui il test dal server con curl -I https://the-site.example/recipe e leggi la riga dello stato prima di attribuire il problema allo scraper. Dalla v3.26.0 Mealie rifiuta inoltre le richieste verso indirizzi privati o interni, quindi una pagina di ricette ospitata sulla tua rete non verrà importata finché non aggiungi il relativo host alla variabile d'ambiente HTTP_ALLOW_LIST.

Dove si colloca

Mealie è una buona prima applicazione self-hosted per una famiglia, perché le persone con cui vivi la useranno senza che sia necessario chiederglielo. Svolge un tipo di attività simile a gestire una propria libreria di foto con Immich, anche se in modo molto più leggero, e rientra nell’elenco più ampio delle soluzioni che vale la pena ospitare autonomamente quest’anno. Un piccolo server può eseguire entrambe. Immich non è l’unica opzione per il secondo servizio e, se non hai ancora deciso, i requisiti minimi di memoria e i comandi di backup di PhotoPrism e Immich sono abbastanza diversi da meritare una lettura prima di allocare lo spazio restante sul disco. Se la famiglia conserva anche piani e appunti, oltre alle ricette, un workspace AFFiNE self-hosted ripropone lo stesso esercizio con il file Compose, ma richiede quattro container e molta più memoria di Mealie. Controlla quindi prima quante risorse restano sul server. Se la famiglia vuole tenere traccia anche dell’allenamento, oltre alle ricette, openGym conserva gli allenamenti e richiede lo stesso tag fissato, il file Compose e il certificato che hai appena configurato. Anche la serata dopo cena ha una variante di questo approccio: Halcyon ricostruisce una libreria Jellyfin esistente come un videonoleggio degli anni 1990 da esplorare, aggiungendo un altro piccolo container davanti a qualcosa che già esegui, invece di introdurre un altro database da sottoporre a backup. Non tutte le applicazioni di questa famiglia sono destinate all’uso domestico. Se la stessa esigenza dovesse riguardare il lavoro, un help desk Chatwoot self-hosted usa di nuovo lo stesso tag fissato e lo stesso certificato, con Postgres, Redis e l’invio della posta in uscita configurati correttamente. Si tratta però di un carico molto più pesante di un ricettario e merita un server dedicato.

FAQ

Perché l'importazione dell'URL di una ricetta non riesce?

Le cause comuni sono due. La pagina potrebbe non pubblicare dati strutturati sulle ricette. In questo caso lo scraper non trova nulla e, se non è configurato un provider AI per leggere la pagina, si ottiene un titolo senza ingredienti. In alternativa, un livello di protezione anti-bot davanti al sito potrebbe restituire una pagina di verifica invece della ricetta. Nel secondo caso, Mealie può essere configurato per usare un proxy con una reputazione dell'indirizzo migliore oppure un'istanza self-hosted di FlareSolverr, che risolve la verifica in un browser reale. Prima di modificare la configurazione, verificare che il server riesca almeno a raggiungere la pagina con curl -I.

È necessario PostgreSQL o SQLite è sufficiente?

SQLite è sufficiente per un'abitazione ed è il database predefinito. Passare a PostgreSQL quando la directory dei dati si trova su uno storage collegato tramite rete, perché SQLite su un filesystem di rete produce errori di database bloccato e può danneggiare il file. I ripristini con PostgreSQL richiedono che l'utente del database sia un superuser, poiché il ripristino elimina tutto prima di caricare l'archivio.

Posso eseguire Mealie senza un nome di dominio?

Sì, sulla propria rete. Impostare BASE_URL sull'indirizzo che si digiterà effettivamente, ad esempio http://192.168.1.20:9925, modificare il mapping delle porte in 192.168.1.20:9925:9000 usando l'indirizzo LAN del server e ignorare nginx. Eseguire sudo docker compose up -d per applicare entrambe le modifiche. Il mapping originale 127.0.0.1:9925:9000 accetta connessioni soltanto dall'host Docker. I link di invito e di reimpostazione della password vengono creati a partire da BASE_URL, quindi un valore errato produce link che nessun altro può aprire. Non esporre il servizio a Internet tramite HTTP semplice, perché in questo caso le credenziali di accesso vengono trasmesse in chiaro.

Come posso assegnare alla mia famiglia credenziali personali?

Lasciare ALLOW_SIGNUP impostato su "false" e aggiungere le persone dall'area amministrativa. Verrà creato un link di invito da inviare loro. Inserire nello stesso household tutte le persone che condividono una cucina, in modo che condividano il piano dei pasti e la lista della spesa. Le ricette vengono condivise comunque con ogni household del gruppo. Chi ha bisogno di raccolte separate deve quindi appartenere a gruppi separati.

Cosa succede alle mie ricette se smetto di usare Mealie?

Vengono esportate. Il backup dell'area amministrativa salva i dati in formato JSON e Mealie può anche esportare le ricette come file JSON, leggibili in qualsiasi editor di testo senza alcun software aggiuntivo. Eseguire un'esportazione prima di averne bisogno e verificare di riuscire ad aprirla.

Questo articolo ti è stato utile?