Mealie Docker Compose: Gestiona Recetas y Planifica Menús 2025

¿Cansado de perder tus recetas favoritas en cuadernos o aplicaciones de pago? Mealie Docker Compose es la solución self-hosted perfecta para gestionar todas tus recetas, planificar menús semanales y generar listas de compra automáticas. En esta guía completa aprenderás a instalarlo en menos de 10 minutos.

¿Qué es Mealie Docker Compose?

Mealie Docker Compose es un gestor de recetas self-hosted con más de 10.700 estrellas en GitHub que te permite organizar tu colección de recetas, importar automáticamente desde URLs, planificar comidas y compartir recetas con tu familia. A diferencia de aplicaciones comerciales como Paprika o Cookpad, tienes control total de tus datos sin suscripciones mensuales.

Este gestor combina un backend robusto desarrollado en Python con una interfaz moderna en Vue, ofreciendo una experiencia fluida tanto en escritorio como en móviles. La instalación mediante contenedores Docker garantiza un despliegue rápido y sin dependencias complejas.

Características principales de Mealie Docker Compose

El gestor de recetas ofrece funcionalidades que compiten directamente con soluciones comerciales:

• Importación automática: Extrae recetas desde cualquier URL con un scraper inteligente que reconoce ingredientes, pasos y tiempos de cocción
• Planificador de menús: Crea planes semanales, mensuales o anuales con arrastrar y soltar
• Listas de compra inteligentes: Genera automáticamente listas organizadas por secciones del supermercado basadas en tus menús
• Multiusuario: Comparte recetas y planes con grupos familiares o equipos
• Editor markdown: Escribe notas y modificaciones con formato enriquecido
• API completa: Integra con Home Assistant, iOS Shortcuts y servicios externos mediante webhooks
• Backups automáticos: Protege tus datos con copias de seguridad programadas
• 35+ idiomas: Interfaz completamente traducida incluido español

Requisitos previos para instalar Mealie Docker Compose

Antes de comenzar con la instalación, asegúrate de tener:

• Docker y Docker Compose instalados (versión 20.10 o superior recomendada)
• 2GB de RAM mínimo (4GB recomendado para mejor rendimiento)
• 5GB de espacio en disco para la aplicación y base de datos
• Acceso SSH a tu servidor si instalas remotamente
• Puerto 9925 disponible (configurable según tus necesidades)

Si aún no tienes Docker instalado, puedes consultar la documentación oficial de Docker para tu sistema operativo.

Instalación paso a paso de Mealie Docker Compose

La instalación es sorprendentemente sencilla. Primero, crea un directorio para el proyecto:

mkdir -p ~/mealie
cd ~/mealie

Ahora crea el archivo de configuración con este comando:

cat > docker-compose.yml <<EOF
version: "3.8"

services:
  mealie:
    image: ghcr.io/mealie-recipes/mealie:latest
    container_name: mealie
    restart: unless-stopped
    ports:
      - "9925:9000"
    environment:
      # Configuración básica
      PUID: 1000
      PGID: 1000
      TZ: Europe/Madrid
      
      # Base de datos (SQLite por defecto)
      DB_ENGINE: sqlite
      
      # Seguridad
      ALLOW_SIGNUP: "false"
      MAX_WORKERS: 1
      WEB_CONCURRENCY: 1
      
      # URLs base (ajusta según tu dominio)
      BASE_URL: http://localhost:9925
      
    volumes:
      - ./data:/app/data
    deploy:
      resources:
        limits:
          memory: 1000M
EOF

Este archivo mealie docker compose utiliza SQLite como base de datos, que es perfecta para la mayoría de usuarios. Si esperas más de 10 usuarios simultáneos, considera PostgreSQL siguiendo la documentación oficial de Mealie.

Levantar los contenedores

Ejecuta el siguiente comando para iniciar el servicio:

docker compose up -d

Docker descargará la imagen (aproximadamente 400MB) y en menos de 2 minutos tendrás la aplicación funcionando. Verifica el estado con:

docker compose ps

Deberías ver el contenedor mealie en estado Up.

Configuración inicial de Mealie Docker Compose

Accede a la interfaz web navegando a http://TU-IP:9925. En la primera ejecución, mealie docker compose te pedirá crear una cuenta de administrador:

1. Introduce tu nombre completo
2. Elige un nombre de usuario
3. Configura una contraseña segura (mínimo 8 caracteres)
4. Proporciona un email válido

Una vez dentro, te recomiendo ajustar estos parámetros en Settings:

• Idioma: Cambia a Español en «User Preferences»
• Tema: Elige entre claro, oscuro o automático
• Backups: Programa copias diarias en «Site Settings > Backups»
• Webhooks: Conecta con Home Assistant si lo usas

Importar recetas automáticamente con Mealie Docker Compose

Una de las funcionalidades estrella es la importación desde URLs. Para probar esta característica:

1. Haz clic en el botón + en la esquina superior derecha
2. Selecciona «Import from URL»
3. Pega la URL de cualquier receta (ejemplo: https://www.recetasgratis.net/receta-de-paella-valenciana-73480.html)
4. Haz clic en «Import»

El scraper automático extraerá ingredientes, pasos, tiempos e incluso imágenes. Puedes editar cualquier campo después de importar. La aplicación guarda un enlace a la receta original para referencia futura.

Planificador de menús y listas de compra

El planificador de menús es donde este gestor realmente brilla. Accede desde el menú lateral a «Meal Planner»:

• Arrastra recetas desde tu colección al calendario
• Asigna desayuno, comida, cena o snacks
• Visualiza semana, mes o vista personalizada
• Duplica planes semanales con un clic

Una vez planificado tu menú, genera la lista de compra automáticamente:

1. Ve a «Shopping Lists»
2. Selecciona «Create from Meal Plan»
3. Elige el rango de fechas
4. Revisa y ajusta cantidades

La lista se organiza automáticamente por categorías (verduras, carnes, lácteos, etc.) y puedes marcar ítems conforme compras desde tu móvil. Puedes consultar más detalles en el repositorio oficial de Mealie en GitHub.

Gestión multiusuario y grupos familiares

Si deseas compartir recetas con tu familia, la aplicación permite crear usuarios adicionales. Como administrador:

1. Ve a «Admin > Users»
2. Haz clic en «Create User»
3. Asigna credenciales y permisos
4. Añade usuarios al grupo familiar

Los miembros del grupo pueden ver y usar las mismas recetas, colaborar en planes de comida y compartir listas de compra en tiempo real.

Configuración avanzada con PostgreSQL

Para entornos con múltiples usuarios concurrentes, PostgreSQL ofrece mejor rendimiento. Aquí tienes una configuración optimizada de mealie docker compose con base de datos dedicada:

version: "3.8"

services:
  postgres:
    image: postgres:15-alpine
    container_name: mealie-db
    restart: unless-stopped
    environment:
      POSTGRES_USER: mealie
      POSTGRES_PASSWORD: mealie_secure_password_2025
      POSTGRES_DB: mealie
    volumes:
      - ./postgres-data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U mealie"]
      interval: 10s
      timeout: 5s
      retries: 5

  mealie:
    image: ghcr.io/mealie-recipes/mealie:latest
    container_name: mealie
    restart: unless-stopped
    depends_on:
      postgres:
        condition: service_healthy
    ports:
      - "9925:9000"
    environment:
      PUID: 1000
      PGID: 1000
      TZ: Europe/Madrid
      
      # PostgreSQL
      DB_ENGINE: postgres
      POSTGRES_USER: mealie
      POSTGRES_PASSWORD: mealie_secure_password_2025
      POSTGRES_SERVER: postgres
      POSTGRES_PORT: 5432
      POSTGRES_DB: mealie
      
      ALLOW_SIGNUP: "false"
      BASE_URL: http://localhost:9925
      
    volumes:
      - ./data:/app/data

Cambia mealie_secure_password_2025 por una contraseña robusta. Esta configuración incluye healthchecks para garantizar que PostgreSQL esté listo antes de iniciar el servicio.

Integración con reverse proxy (Nginx/Caddy)

Para acceder desde Internet con HTTPS, necesitas un reverse proxy. Ejemplo con Caddy:

mealie.tudominio.com {
    reverse_proxy mealie:9000
}

O con Nginx Proxy Manager como explico en mi guía de Docker Compose. Asegúrate de actualizar la variable BASE_URL en tu configuración a https://mealie.tudominio.com.

Si usas Caddy, consulta la documentación oficial de Caddy para configuraciones avanzadas.

Backups y restauración de datos

Los datos de tus recetas son valiosos. La aplicación incluye backups automáticos, pero también puedes hacer copias manuales:

# Backup manual
docker compose exec mealie /app/scripts/backup.sh

# O copia el directorio completo
tar -czf mealie-backup-$(date +%Y%m%d).tar.gz ./data

Los backups se almacenan en ./data/backups/ en formato ZIP. Para restaurar, simplemente reemplaza el directorio data con tu backup y reinicia los contenedores.

Solución de problemas comunes

El contenedor no inicia

Verifica los logs:

docker compose logs -f mealie

Problemas comunes incluyen puertos ocupados (cambia 9925 a otro) o permisos en el directorio data.

No se importan recetas correctamente

Algunos sitios web bloquean scrapers. Intenta importar manualmente o usa el bookmarklet que puedes configurar en Settings. También puedes reportar sitios problemáticos en el repositorio de GitHub para que los desarrolladores mejoren el scraper.

Problemas de rendimiento

Si notas lentitud con muchos usuarios, aumenta los límites de recursos en el archivo compose o migra a PostgreSQL. También puedes ajustar MAX_WORKERS y WEB_CONCURRENCY según tu hardware.

Actualizaciones y mantenimiento

Mantener tu instalación actualizada es simple:

docker compose pull
docker compose up -d

Esto descarga la última versión y reinicia el contenedor automáticamente. Los desarrolladores publican actualizaciones regularmente con mejoras y correcciones. Puedes revisar el changelog en las releases oficiales de GitHub.

Preguntas frecuentes sobre Mealie Docker Compose

¿Necesito conocimientos de programación para usar Mealie?

No, solo necesitas saber copiar y pegar comandos básicos. La interfaz web es completamente visual e intuitiva.

¿Puedo importar mis recetas desde otras aplicaciones?

Sí, la aplicación soporta importación masiva desde URLs y también acepta archivos JSON. Existe documentación para migrar desde Paprika y otras plataformas.

¿Es seguro exponer Mealie a Internet?

Siempre usa HTTPS mediante un reverse proxy, deshabilita el registro público (ALLOW_SIGNUP: "false") y utiliza contraseñas fuertes. Considera también implementar autenticación de dos factores si está disponible.

¿Funciona en Raspberry Pi?

Sí, perfectamente en Raspberry Pi 4 con al menos 2GB de RAM. Usa la imagen ARM64 que se descarga automáticamente.

¿Hay aplicación móvil?

La interfaz web es totalmente responsive y funciona perfecto en móviles. Puedes agregar un acceso directo a tu pantalla de inicio que se comporta como una app nativa.

Conclusión

Mealie Docker Compose representa una alternativa completa y gratuita a gestores de recetas comerciales. Con importación automática, planificación de menús inteligente y listas de compra generadas al instante, toda tu familia disfrutará de una experiencia culinaria organizada sin pagar suscripciones mensuales.

El control total de tus datos, combinado con la facilidad de instalación mediante contenedores, convierte esta solución en la opción perfecta tanto para principiantes como para usuarios avanzados. Con más de 10.000 estrellas en GitHub y una comunidad activa en Discord, estás respaldado por desarrolladores comprometidos y usuarios que comparten recetas y trucos constantemente.

¿Ya tienes tu servidor funcionando? Comparte tu experiencia en los comentarios y cuéntanos qué te parece esta fantástica herramienta de gestión de recetas.