Mealie: il tuo ricettario, pianificatore dei pasti e lista della spesa su VPS

Una ricetta rimane nei preferiti, un’altra in una chat, una terza in uno screenshot, mentre la quarta deve essere ritrovata su un sito tra pubblicità e una lunga introduzione. Mealie riunisce tutto in un unico posto: incolli un link e ottieni una scheda con ingredienti, istruzioni e fotografia. Puoi quindi aggiungere il piatto al calendario e trasferire i prodotti in una lista della spesa condivisa.

Di seguito vedremo cosa può fare Mealie, a chi può essere utile, quale server serve e come avviare il proprio gestore di ricette su una VPS con Docker Compose.

Che cos’è Mealie

Mealie è un’applicazione gratuita self-hosted per archiviare ricette, pianificare i pasti e gestire le liste della spesa. Il servizio funziona sul tuo server, quindi sei tu a decidere dove viene conservato il database, chi può accedere e come vengono creati i backup.

L’interfaccia si apre nel browser da computer o telefono. Le ricette possono essere create manualmente, importate dai siti, organizzate in categorie e libri di cucina, aggiunte a un menu settimanale e condivise con la famiglia.

La principale differenza tra Mealie e una cartella di appunti è il collegamento tra gli elementi. Una ricetta può essere aggiunta a un piano dei pasti, collegata a una lista della spesa, filtrata tramite tag e utilizzata nelle automazioni attraverso l’API.

Le principali funzioni di Mealie

Importare una ricetta con un solo link

L’utente incolla un URL e Mealie prova a estrarre il nome del piatto, il numero di porzioni, gli ingredienti, i passaggi e l’immagine. Invece di un altro preferito, rimane una scheda ordinata che può essere modificata e salvata.

Questa funzione è particolarmente utile per i siti in cui la ricetta è circondata da pubblicità e testo superfluo. Se una pagina usa una struttura non standard, a volte è necessario correggere alcuni dati manualmente.

Mealie può anche trasferire collezioni da Paprika, Tandoor, Nextcloud Cookbooks e diversi altri gestori di ricette. Non è necessario iniziare con una libreria vuota.

Importare da una foto, un testo o un video

Un’integrazione IA facoltativa può ricostruire una ricetta partendo da un testo, dalla fotografia di una pagina di un libro di cucina o da un link video. Per i video, il servizio ottiene una trascrizione e poi ricava gli ingredienti e l’ordine dei passaggi.

Questa funzione richiede un provider IA compatibile. È possibile collegare un’API esterna oppure un proprio servizio compatibile con OpenAI, come Ollama. Prima di attivarlo, conviene considerare il costo delle richieste e la politica di trattamento dei dati del provider scelto.

Pianificatore dei pasti e lista della spesa

I piatti vengono organizzati per giorno e tipo di pasto. Puoi aggiungere una ricetta, una nota come «avanzi di ieri» oppure un piatto casuale in base a una regola, per esempio selezionare il venerdì soltanto cene veloci.

Gli ingredienti delle ricette vengono trasferiti nella lista della spesa. Le voci possono essere spuntate dal telefono e raggruppate per reparto del negozio. In questo modo Mealie non è più soltanto un archivio, ma diventa uno strumento pratico per tutta la settimana.

Accesso familiare e automazioni

Mealie supporta utenti, gruppi e nuclei familiari. Una famiglia può usare una raccolta condivisa di ricette mantenendo, quando necessario, piani dei pasti e liste della spesa separati.

L’API REST, le notifiche e i webhook permettono di collegare il servizio ad altri sistemi. L’integrazione ufficiale con Home Assistant, per esempio, mostra i pasti futuri nel calendario e funziona con la lista della spesa.

A chi è adatto Mealie

Mealie è utile quando le ricette sono sparse tra siti, appunti e fotografie; quando il menu deve essere ricreato ogni volta; quando più persone usano la stessa lista della spesa; quando è importante controllare il proprio database; oppure quando servono automazioni.

Il servizio può essere eccessivo se hai soltanto pochi piatti abituali e non vuoi occuparti della manutenzione di Docker. Il self-hosting elimina la dipendenza da un account cloud di terzi, ma il server deve comunque essere aggiornato, protetto e sottoposto a backup.

Quale server serve per Mealie

Nella configurazione ufficiale di Docker Compose, il container è limitato a 1000 MB di memoria. Per una piccola installazione sono sufficienti 1 vCPU e 1 GB di RAM, ma una VPS con 2 GB offre margine per Linux, Docker, un proxy inverso e gli aggiornamenti. Lo spazio su disco viene utilizzato soprattutto per fotografie e backup.

Scenario	CPU	RAM	Disco
Database personale con SQLite	1 vCPU	1 GB	SSD da 10–20 GB
Famiglia, HTTPS e altri container	1–2 vCPU	2 GB	SSD da almeno 20 GB
PostgreSQL o molti utenti	2 vCPU	2–4 GB	SSD da almeno 20 GB

Questi sono valori iniziali pratici, non un requisito minimo ufficiale rigido. Se l’IA funziona tramite un’API esterna, i calcoli non vengono eseguiti sulla VPS. Le risorse per un modello locale devono essere calcolate separatamente.

SQLite o PostgreSQL

SQLite è più semplice ed è consigliato dalla documentazione di Mealie per 1–20 utenti con poche operazioni simultanee. Per un’installazione personale o familiare è generalmente il miglior punto di partenza.

PostgreSQL è preferibile in presenza di un carico simultaneo elevato, quando serve la ricerca approssimativa oppure quando i dati sono conservati su uno storage di rete. L’uso di SQLite su un NAS è sconsigliato, perché possono verificarsi blocchi del database e corruzione dei dati.

Installare Mealie su una VPS con Docker Compose

L’esempio seguente utilizza SQLite. Docker Engine e Docker Compose devono essere già installati sul server. È adatto un sistema Ubuntu o Debian a 64 bit su amd64 o arm64.

1. Crea una directory

sudo mkdir -p /opt/mealie
cd /opt/mealie
sudo nano docker-compose.yml

2. Aggiungi la configurazione

services:
  mealie:
    image: ghcr.io/mealie-recipes/mealie:v3.24.0
    container_name: mealie
    restart: unless-stopped
    ports:
      - "9925:9000"
    deploy:
      resources:
        limits:
          memory: 1000M
    volumes:
      - mealie-data:/app/data/
    environment:
      ALLOW_SIGNUP: "false"
      PUID: "1000"
      PGID: "1000"
      TZ: "Etc/UTC"
      BASE_URL: "https://recipes.example.com"

volumes:
  mealie-data:

Sostituisci TZ e BASE_URL con i tuoi valori. Al 29 agosto 2026, la versione attuale è v3.24.0. Prima dell’installazione controlla la versione più recente e usa un tag specifico al posto di latest, per evitare aggiornamenti inattesi.

3. Avvia Mealie

sudo docker compose up -d
sudo docker compose ps

Apri http://IP_DEL_SERVER:9925. Il nome utente predefinito è [email protected] e la password è MyPassword. Modifica subito le credenziali dell’amministratore.

4. Attiva HTTPS

Per un accesso permanente, associa un dominio, posiziona Nginx, Caddy o Traefik davanti a Mealie e genera un certificato TLS. Dopodiché limita la porta a localhost:

ports:
  - "127.0.0.1:9925:9000"

Se il servizio serve soltanto in casa, puoi evitare di pubblicarlo su Internet e accedervi tramite una VPN.

Cosa configurare dopo l’avvio

Cambia la password, verifica che la registrazione aperta sia disattivata e crea gli account dei familiari. Aggiungi poi alcuni tag semplici, per esempio «veloce», «da congelare» e «cena». Una struttura troppo complessa all’inizio crea soltanto ostacoli.

Importa alcune ricette reali, controlla le porzioni e le unità di misura, aggiungi i piatti al pianificatore e crea la prima lista della spesa. In questo modo il flusso principale di Mealie diventa chiaro in una sola serata.

Sicurezza e backup

Un’installazione pubblica richiede una password robusta, HTTPS, registrazione chiusa e aggiornamenti regolari. La documentazione avverte in modo specifico riguardo ai metodi API che importano URL: senza un limite alla frequenza delle richieste possono generare un carico inutile. È preferibile configurare un rate limit sul proxy inverso.

Poiché durante l’importazione il container si collega a indirizzi esterni, in una rete domestica sensibile Mealie dovrebbe essere isolato dai servizi interni.

Dal pannello di amministrazione è possibile creare, scaricare e ripristinare un backup completo. Tuttavia, Mealie non esegue più backup automatici programmati. Con SQLite è inoltre più sicuro copiare l’intero volume /app/data su uno spazio di archiviazione esterno. Un backup conservato sulla stessa VPS non protegge dalla perdita del server.

Limiti di Mealie

L’importazione dipende dalla struttura del sito, quindi alcune schede devono essere corrette manualmente. Anche il ridimensionamento delle quantità degli ingredienti può produrre errori se la ricetta originale usa testo libero invece di unità standard.

Il client principale è l’interfaccia web. È comoda in un browser mobile, ma le applicazioni native vengono sviluppate separatamente. Inoltre, il proprietario è responsabile di Docker, HTTPS, aggiornamenti e backup.

Mealie è particolarmente efficace come processo continuo: salvare una ricetta trovata, programmarla per un giorno e non dimenticare gli ingredienti.

Mealie su una VPS di tropic.host

Un server domestico è adatto se rimane sempre acceso e l’accesso remoto è già configurato. Una VPS è più comoda quando le ricette e la lista della spesa devono essere disponibili ovunque, senza inoltrare porte attraverso il router di casa.

Per un’installazione familiare puoi utilizzare una VPS Linux di tropic.host con 2 GB di RAM. Sono sufficienti per Mealie, Docker e un proxy inverso con un margine ragionevole. Puoi iniziare con SQLite e, quando il carico aumenta, espandere le risorse o passare a PostgreSQL.

Una VPS non sostituisce i backup: il database e le fotografie delle ricette devono essere esportati separatamente con regolarità.

Breve conclusione

Mealie conserva le ricette in un formato ordinato, aiuta a pianificare i menu e riunisce gli ingredienti in una lista della spesa condivisa. La funzione più potente è l’importazione tramite link, mentre l’accesso familiare, il pianificatore e le integrazioni trasformano la libreria in uno strumento quotidiano.

Per un utilizzo personale o familiare sono sufficienti una piccola VPS, Docker e SQLite. In cambio, sarà necessario controllare aggiornamenti, HTTPS e backup.

FAQ

Mealie è gratuito?

Sì. Il progetto è distribuito con licenza AGPL-3.0. Possono esserci costi per la VPS, il dominio e le richieste IA esterne.

È possibile importare ricette da siti in lingua russa?

Sì, se la pagina contiene una struttura della ricetta comprensibile. La qualità dipende dal sito; gli errori possono essere corretti manualmente o tramite l’importazione con IA.

Quanta RAM serve a Mealie?

Per una piccola installazione con SQLite puoi iniziare con 1 GB. Per una VPS con Linux, un proxy inverso e altri container, 2 GB sono più pratici.

È necessario un dominio?

No. In una rete locale o tramite VPN è sufficiente un indirizzo IP. Per un accesso sicuro da Internet, un dominio e HTTPS sono più comodi.

Cosa scegliere: SQLite o PostgreSQL?

SQLite è più semplice e adatto alla maggior parte delle installazioni con 1–20 utenti. PostgreSQL è migliore con un carico simultaneo elevato, per l’archiviazione su NAS o quando serve la ricerca approssimativa.