Instalar Mealie con Docker Compose en una VPS
Despliega Mealie en tu servidor usando Docker Compose. Aprende a gestionar recetas, generar listas de compra y configurar TLS con Nginx en una VPS con pocos recursos.
Qué hace un gestor de recetas autoalojado
Un gestor de recetas autoalojado guarda tus recetas en una base de datos de un servidor que administras, y Mealie es la opción que elige la mayoría de los hogares. Pegas la dirección de una página de recetas y Mealie extrae los ingredientes, los pasos, las cantidades y el tiempo de cocción, y descarta el texto narrativo y la publicidad. En tu colección sólo queda la receta.
El resto de la aplicación es pequeño. Incluye un plan semanal de comidas al que arrastras recetas y una lista de la compra que se genera a partir de ese plan. Cada persona que cocina tiene su propio inicio de sesión. Todo se ejecuta en un contenedor y permanece inactivo entre peticiones, por lo que una VPS modesta puede alojarlo sin problemas.
Esta guía usa Docker Compose. Si los términos services: y volumes: son nuevos para ti, lee primero cómo se estructuran los archivos de Docker Compose, porque todo lo que sigue consiste en un archivo compose y cuatro comandos.
Instalar Mealie con Docker Compose
Mealie publica sus imágenes en el registro de contenedores de GitHub. A fecha del 18 de noviembre de 2026, la etiqueta estable actual es v3.31.0, publicada el 13 de noviembre. Esta versión incluye correcciones de seguridad y el proyecto recomienda que todos actualicen. Fije una versión en lugar de usar latest: con latest, un docker compose pull en un día no relacionado puede hacerle pasar a una migración de base de datos para la que aún no estaba preparado.
sudo mkdir -p /srv/mealie
cd /srv/mealie
sudo nano docker-compose.ymlservices:
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:Conviene revisar dos líneas antes de iniciarlo.
El puerto aparece como 127.0.0.1:9925:9000 y no como 9925:9000. El contenedor escucha en 9000 internamente y el host asigna el puerto 9925 a ese puerto. Vincular esa asignación a la dirección de loopback permite que nginx llegue a Mealie, pero impide el acceso desde Internet. Docker escribe sus propias reglas en el filtro de paquetes, por lo que un 9925:9000 simple es accesible desde fuera aunque el firewall indique que el puerto está cerrado. Conviene entender esta sorpresa una vez: consulte por qué los puertos publicados por Docker ignoran ufw.
BASE_URL debe ser la dirección pública exacta que utilizará, con el esquema y sin una barra final. Mealie genera a partir de ella los enlaces para restablecer contraseñas y los enlaces de invitación. Si la establece en http://localhost:9925, la invitación que envíe a su pareja contendrá un enlace que sólo funcionará en el propio servidor.
Inícielo y supervise el primer arranque.
sudo docker compose up -d
sudo docker compose logs -f mealieEl primer arranque crea la base de datos SQLite y ejecuta las migraciones, lo que tarda unos segundos. Cuando el registro se estabilice y deje de mostrar líneas de migración, compruebe la aplicación localmente.
curl -I http://127.0.0.1:9925Un 200 OK indica que la aplicación está activa. Si obtiene Connection refused, ejecute sudo docker compose ps -a para comprobar el estado y el código de salida del contenedor. Un contenedor detenido con el código 137 recibió SIGKILL; ese código por sí solo no demuestra que haya superado el límite de memoria de 1000M. Detener el contenedor manualmente también produce ese código.
Primer inicio de sesión y desactivación del registro abierto
La cuenta predeterminada es changeme@example.com y la contraseña es MyPassword. Inicie sesión con ellas y cambie ambas de inmediato, porque esa combinación aparece en la documentación y, por tanto, está incluida en todos los escáneres.
ALLOW_SIGNUP: "false" en el archivo compose es intencionado. Con el registro abierto, cualquiera que encuentre la dirección puede crear una cuenta en su recetario. Con el registro cerrado, usted añade a las personas desde el área de administración, que genera un enlace de invitación para enviarlo personalmente. Ese enlace se crea a partir de BASE_URL, por lo que este valor es importante. Si termina ejecutando varias aplicaciones en el mismo servidor y quiere usar una sola contraseña para todas, Mealie puede delegar el inicio de sesión en un proveedor de identidad externo, como una instancia de Authentik autohospedada.
Mealie asigna los usuarios a un hogar, y los hogares se agrupan dentro de un grupo. Todas las personas de un mismo hogar comparten el plan de comidas y la lista de compras, que es lo que necesita una familia. La colección de recetas es más amplia: los hogares comparten sus recetas, etiquetas y categorías con todos los demás hogares del mismo grupo. Por tanto, los hogares separados de un mismo servidor mantienen planes y listas independientes, pero cocinan con las mismas recetas. Esto también resulta adecuado para un piso compartido donde nadie se pone de acuerdo sobre las anchoas. Si necesitan colecciones completamente independientes, asígneles grupos distintos, porque no se comparte nada entre grupos.
El importador, que es el motivo para ejecutar esto
Abra la colección de recetas, elija crear una receta a partir de una URL y pegue un enlace. Mealie carga la página y busca datos estructurados de recetas: el bloque legible por máquina que la mayoría de los sitios de recetas insertan para los motores de búsqueda. Si ese bloque está presente, la importación es limpia e inmediata.
Si configura un proveedor de IA, también puede importar desde una imagen o desde texto sin formato que pegue directamente. Esto permite importar una fotografía de una página de un libro de cocina. La importación de imágenes necesita un proveedor capaz de leer imágenes. Sin un proveedor, estas importaciones no están disponibles. Siguen un proceso más lento y deben revisarse después, porque una fracción escrita a mano se puede interpretar fácilmente de forma incorrecta.
Las importaciones masivas se ejecutan desde la misma pantalla: pegue una lista de direcciones, una por línea, y Mealie las procesa en segundo plano. Una colección de doscientas marcadores se puede importar en una sola sesión.
Planes de comidas y lista de compras
El planificador de comidas es un calendario. Arrastre una receta a un día para planificarla. Añada las recetas planificadas a una lista de compras para recopilar sus ingredientes. Para combinar duplicados, primero cree los alimentos y las unidades en Manage Data, active las cantidades de ingredientes en cada receta y analice sus ingredientes para asociarlos con esos alimentos y unidades. Así, si dos recetas necesitan cebollas, aparecerá una sola línea en lugar de dos.
La lista es una página activa en el teléfono mientras hace las compras. Como el servidor propio la almacena, todas las personas del hogar ven la misma lista al mismo tiempo. Cuando una persona marca la leche como comprada, desaparece de la pantalla de la otra.
Configurar nginx y TLS delante de Mealie
En esta configuración, Mealie usa HTTP sin cifrar. También admite TLS mediante TLS_CERTIFICATE_PATH y TLS_PRIVATE_KEY_PATH. Termine TLS en nginx, delante de Mealie. Primero apunte un registro DNS A a su servidor, porque el paso de emisión del certificado verifica ese nombre.
sudo apt update && sudo apt install -y nginx
sudo nano /etc/nginx/sites-available/mealieserver {
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 nginxnginx -t que muestre syntax is ok y test is successful es el requisito. Recargue nginx sólo después de que la comprobación se complete correctamente. Si recarga una configuración incorrecta, nginx mantiene activa la configuración anterior y el error queda oculto hasta el siguiente reinicio.
client_max_body_size 64M es necesario porque el valor predeterminado de nginx es 1 MB. Al cargar una foto de una receta o restaurar una copia de seguridad desde el navegador, el cuerpo de la petición supera ese tamaño. Sin esa línea, nginx devuelve 413 Request Entity Too Large, no Mealie, por lo que el registro de la aplicación no muestra nada.
A continuación, emita el certificado. Ese paso y su temporizador de renovación se describen en emitir un certificado de Let's Encrypt para nginx con certbot.
sudo apt install -y certbot python3-certbot-nginx
sudo certbot --nginx -d recipes.example.comCertbot modifica el bloque de servidor para escuchar en 443 y añade una redirección desde el puerto 80. Cargue el sitio mediante https:// y confirme que el navegador acepta el certificado. Si Mealie se carga, pero sus propios enlaces le envían a http://, entonces BASE_URL todavía contiene http. Corríjalo y ejecute sudo docker compose up -d para recrear el contenedor con el nuevo valor.
No es posible servir Mealie bajo una subruta como example.com/recipes, porque el frontend no puede servirse desde una subruta. Use un subdominio.
Copias de seguridad y lo que hace realmente una restauración
Todo lo que gestiona Mealie se encuentra en /app/data/ dentro del contenedor, que es el volumen mealie-data. Si copia ese volumen, copia conjuntamente las recetas, las imágenes y la base de datos. La documentación de Mealie indica que detener el contenedor y copiar esta carpeta es la mejor forma de hacer una copia de seguridad de una instalación 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 mealieEl nombre del volumen lleva el nombre del proyecto como prefijo, y el nombre del proyecto es el directorio que contiene el archivo compose. Desde /srv/mealie, el volumen es mealie_mealie-data, por lo que el primer comando es docker volume ls: use el nombre que muestra, no el nombre de esta guía. Es importante detener primero el contenedor, porque SQLite está escribiendo en mitad de una operación con suficiente frecuencia como para que una copia activa se restaure como un archivo ilegible.
Mealie también tiene su propia página de copias de seguridad en el área de administración, que escribe un archivo zip con la base de datos como database.json. Puede restaurar un archivo en una instancia que ejecute la misma versión de Mealie o una más reciente. Para cambiar de servidor, ejecute la misma versión fijada en el servidor nuevo al copiar el volumen, o restaure el archivo en la misma versión o en una más reciente. Restaurar una copia es destructivo por diseño: elimina la base de datos actual antes de cargar el archivo y no se puede deshacer. La sesión se cierra cuando termina.
Ninguna de las dos copias es una copia de seguridad mientras permanezca en el mismo servidor. Envíe el archivo periódicamente a otra ubicación. Para eso sirve hacer copias de seguridad cifradas fuera del servidor con restic.
Actualizar Mealie
cd /srv/mealie
sudo nano docker-compose.yml
sudo docker compose pull
sudo docker compose up -d
sudo docker compose logs -f mealieAumente la versión fijada en el archivo y, después, descargue la imagen y vuelva a crear el contenedor. Las migraciones se ejecutan durante el primer arranque de la nueva imagen. Haga una copia del volumen antes de cambiar de versión principal, porque una migración que falla a mitad del proceso puede dejar una base de datos que la imagen anterior ya no podrá abrir. Lea las notas de la versión correspondientes a todos los cambios entre su versión actual y la nueva.
Cuando falla el importador
Algunos sitios no publican ningún dato estructurado de recetas, por lo que Mealie importa el título con una lista de ingredientes vacía. Sin un proveedor de IA no puede corregirlo mediante configuración, así que pegue manualmente el texto de la receta. Con un proveedor configurado, Mealie entrega al modelo el contenido de la página cuando el scraper no encuentra nada. El resultado debe comprobarse contra el original igual que cualquier otra importación de IA.
Otros fallos se deben a la protección contra bots situada delante del sitio de recetas, que responde a Mealie con una página de desafío en lugar de la receta. Mealie ya simula un navegador y rota su agente de usuario para reducir este problema. Si un sitio sigue rechazando la petición, las opciones documentadas son enviar el scraper a través de un proxy con mejor reputación de dirección, o ejecutar una instancia de FlareSolverr que resuelva el desafío en un navegador real. Ambas opciones son voluntarias y se configuran mediante variables de entorno en el contenedor.
Un fallo de importación causado por la imposibilidad de que el servidor llegue al sitio es un problema diferente. Pruébelo desde el servidor con curl -I https://the-site.example/recipe y lea la línea de estado antes de culpar al scraper. Desde v3.26.0, Mealie también rechaza las peticiones a direcciones privadas o internas. Por tanto, una página de recetas alojada en su propia red no se importará hasta que añada su host a la variable de entorno HTTP_ALLOW_LIST.
Dónde encaja
Mealie es una buena primera aplicación autohospedada para un hogar, porque las personas con las que vive la usarán sin que tenga que pedírselo. Cumple una función parecida a su propia biblioteca de fotos con Immich, aunque es mucho más ligera, y forma parte de la lista más amplia de servicios que merece la pena autohospedar este año. Un solo servidor puede alojar ambas aplicaciones. Immich no es la única opción para esa segunda función y, si todavía está decidiendo, los requisitos mínimos de memoria y los comandos de copia de seguridad de PhotoPrism e Immich son suficientemente distintos como para que convenga leerlos antes de destinar el resto del disco. Si el hogar también guarda sus planes y notas, además de sus cenas, un espacio de trabajo AFFiNE autohospedado vuelve a ser el mismo ejercicio con un archivo compose, pero necesita cuatro contenedores y bastante más memoria que Mealie, así que compruebe primero cuánta memoria queda disponible en el equipo. Y si el hogar quiere registrar también sus entrenamientos, además de sus cenas, openGym conserva los entrenamientos y requiere la misma etiqueta fijada, el mismo archivo compose y el mismo certificado que acaba de configurar. La velada posterior a la cena tiene su propia variante, porque Halcyon reconstruye una biblioteca Jellyfin existente como un videoclub de los años 90 por el que puede desplazarse, lo que añade otro contenedor pequeño delante de algo que ya ejecuta, en lugar de otra base de datos que haya que respaldar. No todo lo de esta familia es una aplicación doméstica y, si alguna vez el mismo enfoque tiene que cubrir una necesidad de trabajo, un servicio de asistencia Chatwoot autohospedado vuelve a requerir la misma etiqueta fijada y el mismo certificado, con Postgres, Redis y el correo saliente operativo detrás. Es un servicio mucho más pesado que un gestor de recetas y merece su propio servidor.
FAQ
¿Por qué falla la importación de una URL de receta?
Hay dos causas habituales. La página no publica datos estructurados de recetas, por lo que el scraper no encuentra nada y, si no se ha configurado un proveedor de IA para leer la página, sólo obtiene un título sin ingredientes. La otra posibilidad es que una capa de protección contra bots situada delante del sitio devuelva una página de desafío en lugar de la receta. En el segundo caso, puede configurar Mealie para usar un proxy con mejor reputación de dirección, o una instancia de FlareSolverr alojada por usted que resuelva el desafío en un navegador real. Confirme que el servidor puede acceder a la página con curl -I antes de cambiar nada.
¿Necesito PostgreSQL o basta con SQLite?
SQLite basta para un hogar y es la opción predeterminada. Cambie a PostgreSQL cuando el directorio de datos esté en un almacenamiento conectado por red, porque SQLite sobre un sistema de archivos de red produce errores de base de datos bloqueada y puede corromper el archivo. Las restauraciones con PostgreSQL requieren que el usuario de la base de datos sea superusuario, porque la restauración elimina todo antes de cargar el archivo.
¿Puedo ejecutar Mealie sin un nombre de dominio?
Sí, en su propia red. Establezca BASE_URL en la dirección que realmente escribirá, como http://192.168.1.20:9925, cambie la asignación de puertos a 192.168.1.20:9925:9000 usando la dirección LAN de su servidor y omita nginx. Ejecute sudo docker compose up -d para aplicar ambos cambios. La asignación original 127.0.0.1:9925:9000 sólo acepta conexiones desde el host de Docker. Los enlaces de invitación y de restablecimiento de contraseña se generan a partir de BASE_URL, por lo que un valor incorrecto produce enlaces que nadie más puede abrir. No lo exponga a Internet mediante HTTP sin cifrar, porque el inicio de sesión se enviaría en texto claro.
¿Cómo doy a mi familia sus propios inicios de sesión?
Deje ALLOW_SIGNUP establecido en "false" y añada a las personas desde el área de administración. Esto genera un enlace de invitación que puede enviarles. Incluya en el mismo hogar a todas las personas que compartan una cocina para que compartan el plan de comidas y la lista de la compra. Las recetas se comparten con todos los hogares del grupo en cualquier caso, por lo que las personas que necesiten colecciones separadas deben pertenecer a grupos distintos.
¿Qué ocurre con mis recetas si dejo de ejecutar Mealie?
Se conservan. La copia de seguridad del área de administración escribe los datos en formato JSON. Mealie también puede exportar las recetas como archivos JSON, que siguen siendo legibles en cualquier editor de texto sin necesidad de software adicional. Haga una exportación antes de necesitarla y compruebe que puede abrirla.