Instalación de Mealie

Configuración

Después de iniciar Mealie con éxito usando Docker Compose, el siguiente paso será configurar el acceso seguro a través de HTTPS utilizando su nombre de dominio. Usaremos Caddy, un servidor web moderno que obtiene y renueva automáticamente los certificados SSL/TLS de Let's Encrypt.

1. Configuración de DNS

Antes de configurar Caddy, asegúrese de que su dominio o subdominio (por ejemplo, recipes.yourdomain.com) apunte a la dirección IP de su VPS. Para ello, cree o modifique un registro A en la configuración DNS de su registrador de dominios:

Espere un tiempo hasta que los cambios de DNS surtan efecto (esto puede tardar desde unos minutos hasta varias horas).

2. Instalación de Caddy

Ejecutaremos Caddy como un contenedor Docker separado para que pueda servir como proxy inverso para Mealie.

Cree un directorio para la configuración de Caddy:

mkdir -p ~/caddy/data ~/caddy/config # Creamos directorios para los datos y la configuración de Caddy
    

Cree el archivo Caddyfile en el directorio ~/caddy:

nano ~/caddy/Caddyfile # Abrimos el archivo Caddyfile para editar
    

Pegue la siguiente configuración, reemplazando recipes.yourdomain.com con su dominio:

recipes.yourdomain.com {
    # Habilitamos la compresión gzip para acelerar la carga
    encode gzip

    # Establecemos los encabezados de seguridad
    header {
        Strict-Transport-Security max-age=31536000;
        X-Frame-Options DENY
        X-Content-Type-Options nosniff
        X-XSS-Protection "1; mode=block"
        Referrer-Policy strict-origin-when-cross-origin
    }

    # Hacemos proxy de todas las solicitudes al contenedor Docker de Mealie
    reverse_proxy mealie:9000 {
        # Añadimos encabezados para el correcto funcionamiento de WebSocket y HTTP/2
        header_up Host {host}
        header_up X-Real-IP {remote_ip}
        header_up X-Forwarded-For {remote_ip}
        header_up X-Forwarded-Proto {scheme}
    }

    # Habilitamos el registro (opcional)
    log {
        output file /var/log/caddy/access.log
    }
}
    

Guarde el archivo (Ctrl+O, Enter) y salga (Ctrl+X).

3. Adición de Caddy a Docker Compose

Ahora editaremos el archivo docker-compose.yml para añadir el servicio Caddy. Ábralo:

nano ~/mealie/docker-compose.yml # Abrimos docker-compose.yml
    

Añada el siguiente bloque caddy al final del archivo, con el mismo nivel de sangría que mealie:

  caddy:
    image: caddy:2.7.6-alpine # Versión actual de Caddy para 2026
    restart: unless-stopped
    ports:
      - "80:80" # HTTP para Let's Encrypt
      - "443:443" # HTTPS
    volumes:
      - ~/caddy/Caddyfile:/etc/caddy/Caddyfile # Montamos nuestro Caddyfile
      - ~/caddy/data:/data # Para certificados Let's Encrypt
      - ~/caddy/config:/config # Para la configuración de Caddy
      - ~/caddy/logs:/var/log/caddy # Para los logs de Caddy
    environment:
      - PUID=${PUID}
      - PGID=${PGID}
    networks:
      - default # Conectamos a la misma red que Mealie
    depends_on:
      - mealie # Caddy debe iniciarse después de Mealie
    

Asegúrese de que mealie y caddy estén en la misma red Docker (por defecto, es la red creada por Docker Compose, nombrada según el directorio, por ejemplo, mealie_default). En este caso, networks: - default es suficiente.

Guarde los cambios en docker-compose.yml.

4. Inicio de Caddy y actualización de Mealie

Reinicie Docker Compose para que Caddy se inicie y Mealie se reconecte a la nueva configuración:

cd ~/mealie # Asegúrese de estar en el directorio con docker-compose.yml
docker compose down # Detenemos todos los contenedores actuales
docker compose up -d # Iniciamos todos los contenedores (Mealie y Caddy)
    

Caddy solicitará e instalará automáticamente un certificado SSL/TLS para su dominio. Esto puede tardar unos segundos.

5. Verificación del funcionamiento

Abra su dominio (por ejemplo, https://recipes.yourdomain.com) en un navegador web. Debería ver la página de inicio de sesión de Mealie con una conexión HTTPS activa.

También puede verificar la disponibilidad usando curl:

curl -v https://recipes.yourdomain.com # Verificamos la disponibilidad y el certificado
    

En la salida, debería ver información sobre el certificado de Let's Encrypt y un código de respuesta HTTP 200 OK.

Primer inicio de sesión en Mealie: Al iniciar sesión por primera vez, Mealie le pedirá que cree una cuenta de administrador. Rellene el formulario y obtendrá acceso al panel de control.

Copias de seguridad y mantenimiento

Las copias de seguridad regulares y el mantenimiento oportuno son cruciales para cualquier servicio autoalojado. Esto garantiza la seguridad de sus datos y el funcionamiento estable de Mealie.

1. Qué respaldar

Para Mealie, los componentes principales que deben respaldarse son:

• Base de datos: Si utiliza SQLite (por defecto), es el archivo mealie.db. Si es PostgreSQL, es un volcado de la base de datos. Este archivo o volcado contiene todas sus recetas, categorías, usuarios y otra información estructurada.
• Archivos multimedia: Las imágenes cargadas, como las fotos de platos, se almacenan en un directorio separado. Asegúrese de respaldar este directorio por completo.
• Archivos de configuración: Los archivos .env y docker-compose.yml. Contienen configuraciones importantes y secretos necesarios para restaurar el servicio.
• Configuración de Caddy: El archivo Caddyfile y los directorios data/config (para certificados Let's Encrypt).

2. Script simple de copia de seguridad automática

Crearemos un script simple que realizará copias de seguridad de la base de datos SQLite y los archivos multimedia, así como de los archivos de configuración. Luego configuraremos su ejecución a través de cron.

Cree un directorio para las copias de seguridad en el VPS:

mkdir -p ~/backups/mealie # Creamos el directorio para las copias de seguridad de Mealie
    

Cree el archivo de script backup_mealie.sh:

nano ~/backup_mealie.sh # Creamos el script de copia de seguridad
    

Pegue el siguiente contenido:

#!/bin/bash

# Rutas a los directorios
MEALIE_DIR="/home/$USER/mealie"
CADDY_DIR="/home/$USER/caddy"
BACKUP_DIR="/home/$USER/backups/mealie"
TIMESTAMP=$(date +%Y%m%d%H%M%S)
BACKUP_FILE="$BACKUP_DIR/mealie_backup_$TIMESTAMP.tar.gz"

echo "Starting Mealie backup at $TIMESTAMP..."

# 1. Detenemos Mealie para asegurar la integridad de la BD (si se usa SQLite)
# Para Mealie 2.x con SQLite, normalmente se puede prescindir de la detención, pero para garantizarlo se puede detener.
# Si usa PostgreSQL, es mejor hacer un volcado a través de pg_dump sin detener Mealie.
# docker compose -f $MEALIE_DIR/docker-compose.yml stop mealie # Opcional: detenemos el servicio mealie

# 2. Copiamos el archivo de la base de datos SQLite
# Ruta al archivo mealie.db dentro del contenedor, si no está en un volumen separado
# Si mealie.db está en un volumen montado, estará disponible en el host.
# En nuestro docker-compose.yml, Mealie 2.x usa el volumen nombrado 'mealie_data'.
# Para obtener la ruta al archivo en el host, debe encontrar la ruta a este volumen.
# Lo más fácil es hacer un volcado desde el contenedor o copiar el archivo si el volumen está disponible.

# Obtenemos la ruta al volumen mealie_data en el host
MEALIE_VOLUME_PATH=$(docker volume inspect mealie_mealie_data --format '{{ .Mountpoint }}')

if [ -z "$MEALIE_VOLUME_PATH" ]; then
    echo "Error: Could not find mealie_data volume mountpoint. Exiting."
    exit 1
fi

echo "Backing up Mealie data from $MEALIE_VOLUME_PATH..."

# Creamos un directorio temporal para recopilar archivos
TEMP_BACKUP_DIR=$(mktemp -d)

# Copiamos la base de datos (si es SQLite)
cp "$MEALIE_VOLUME_PATH/mealie.db" "$TEMP_BACKUP_DIR/mealie.db"
echo "Copied mealie.db"

# Copiamos los archivos multimedia
cp -R "$MEALIE_VOLUME_PATH/media" "$TEMP_BACKUP_DIR/media"
echo "Copied media files"

# Copiamos los archivos de configuración de Mealie
cp "$MEALIE_DIR/.env" "$TEMP_BACKUP_DIR/mealie_env"
cp "$MEALIE_DIR/docker-compose.yml" "$TEMP_BACKUP_DIR/mealie_docker-compose.yml"
echo "Copied Mealie config files"

# Copiamos los archivos de configuración de Caddy
cp "$CADDY_DIR/Caddyfile" "$TEMP_BACKUP_DIR/caddy_Caddyfile"
# Datos y configuraciones de Caddy (certificados)
cp -R "$CADDY_DIR/data" "$TEMP_BACKUP_DIR/caddy_data"
cp -R "$CADDY_DIR/config" "$TEMP_BACKUP_DIR/caddy_config"
echo "Copied Caddy config and data"

# 3. Archivamos todo en un solo archivo
tar -czf "$BACKUP_FILE" -C "$TEMP_BACKUP_DIR" . # Archivamos el contenido del directorio temporal
echo "Created backup archive: $BACKUP_FILE"

# 4. Eliminamos el directorio temporal
rm -rf "$TEMP_BACKUP_DIR"
echo "Cleaned up temporary directory."

# 5. Iniciamos Mealie de nuevo (si lo detuvimos)
# docker compose -f $MEALIE_DIR/docker-compose.yml start mealie # Opcional: iniciamos el servicio mealie

# 6. Eliminamos copias de seguridad antiguas (por ejemplo, de más de 7 días)
find "$BACKUP_DIR" -type f -name 'mealie_backup_*.tar.gz' -mtime +7 -delete # Eliminamos copias de seguridad de más de 7 días
echo "Removed old backups."

echo "Mealie backup completed."
    

Haga que el script sea ejecutable:

chmod +x ~/backup_mealie.sh # Hacemos el script ejecutable
    

3. Dónde almacenar las copias de seguridad

Almacenar las copias de seguridad en el mismo servidor que el servicio principal no es seguro. En caso de fallo del VPS, perderá tanto los datos como las copias de seguridad. Se recomienda utilizar una de las siguientes soluciones:

• Almacenamiento externo compatible con S3: Por ejemplo, Amazon S3, DigitalOcean Spaces, Backblaze B2. Para esto, puede usar utilidades como rclone o s3cmd en su script.
• VPS separado: Puede configurar un segundo VPS más económico y sincronizar las copias de seguridad allí usando rsync a través de SSH.
• Almacenamiento local: Si tiene un NAS u otro servidor en casa, puede configurar rsync para copiar las copias de seguridad allí.

Por ejemplo, si desea copiar las copias de seguridad a otro servidor a través de SSH, agregue lo siguiente al script después de crear el archivo:

# Copia de seguridad a un servidor remoto
REMOTE_USER="backupuser"
REMOTE_HOST="your_backup_vps_ip"
REMOTE_PATH="/path/to/remote/mealie_backups"

rsync -avz "$BACKUP_FILE" "$REMOTE_USER@$REMOTE_HOST:$REMOTE_PATH" # Copiamos el archivo al servidor remoto
echo "Backup copied to remote server."
    

No olvide configurar las claves SSH para el acceso sin contraseña al servidor remoto.

4. Configuración de Cron para el inicio automático de la copia de seguridad

Abra la tabla Cron para el usuario actual:

crontab -e # Abrimos crontab para el usuario actual
    

Agregue la siguiente línea para que el script se ejecute diariamente a las 03:00 de la madrugada:

0 3 * * * /home/$USER/backup_mealie.sh > /dev/null 2>&1 # Ejecutar el script de copia de seguridad diariamente a las 03:00
    

Guarde y salga. Ahora las copias de seguridad se crearán automáticamente.

5. Actualizaciones: rolling vs ventana de mantenimiento

• Actualizaciones de Mealie: Dado que Mealie se implementa a través de Docker Compose, las actualizaciones son muy sencillas. Solo necesita obtener las nuevas imágenes y reiniciar los contenedores.

  
  cd ~/mealie
  docker compose pull # Descargamos las nuevas versiones de las imágenes
  docker compose up -d # Recreamos los contenedores con las nuevas imágenes
              

  Se recomienda realizar estas actualizaciones en una "ventana de mantenimiento" cuando la actividad del usuario sea mínima, ya que el servicio estará brevemente no disponible. Verifique el repositorio oficial de Mealie en busca de cambios críticos o procedimientos de migración antes de actualizar.
• Actualizaciones del sistema: Actualice regularmente el sistema operativo y los paquetes instalados:

  
  sudo apt update && sudo apt upgrade -y # Actualizamos los paquetes del sistema
              

  Esto se puede hacer una vez a la semana o una vez al mes. Después de grandes actualizaciones del kernel o de las bibliotecas del sistema, puede ser necesario reiniciar el servidor (sudo reboot). Planifique estos reinicios también en la ventana de mantenimiento.
• Actualizaciones de Docker: La actualización de Docker Engine también se realiza a través de apt upgrade. Después de actualizar Docker Engine, se recomienda reiniciar todos los contenedores.

Mantenga un registro de cambios y versiones para todos los componentes, esto ayudará en la resolución de problemas.

Solución de problemas + Preguntas frecuentes

Mealie no se inicia, los contenedores se reinician constantemente. ¿Qué hacer?

Este es un problema común. Primero, verifique los registros del contenedor de Mealie. Vaya al directorio donde se encuentra docker-compose.yml (~/mealie) y ejecute: docker compose logs mealie. Busque errores, como problemas con la base de datos, variables de entorno faltantes, errores del sistema de archivos o permisos incorrectos. Asegúrese de que el archivo .env esté configurado correctamente, especialmente SECRET_KEY y PUID/PGID.

No puedo acceder a Mealie por HTTPS a través del dominio.

Verifique varias cosas: 1) ¿El registro A en el DNS para su dominio está configurado correctamente y apunta a la IP de su VPS? Use dig your.domain.com o herramientas en línea. 2) ¿Caddy está funcionando? Verifique los registros de Caddy: docker compose logs caddy. Busque errores al obtener el certificado Let's Encrypt (por ejemplo, "certificate acquisition failed"). Asegúrese de que los puertos 80 y 443 estén abiertos en UFW (sudo ufw status). Es posible que Caddy no pueda comunicarse con Mealie, verifique el nombre del servicio en Caddyfile (debería ser mealie:9000).

¿Cuál es la configuración mínima de VPS adecuada para Mealie?

Para Mealie, utilizado por una sola persona o una familia pequeña, un VPS con 1 núcleo de CPU, 1 GB de RAM y 20-30 GB de SSD es mínimamente suficiente. Esto será suficiente para el sistema operativo, Docker y Mealie con SQLite. Sin embargo, para un funcionamiento más cómodo y para el futuro, se recomiendan 2 núcleos de CPU, 2 GB de RAM y 50 GB de SSD.

¿Qué elegir: un VPS o un servidor dedicado para esta tarea?

Para Mealie, un VPS es casi siempre suficiente. Los servidores dedicados son excesivos en potencia y costo para una aplicación como esta, a menos que planee atender a un número muy grande de usuarios (cientos o miles, lo cual no es típico para Mealie) o si ya tiene un servidor dedicado para otras tareas de alta carga y desea alojar Mealie en él. Un VPS ofrece mejor flexibilidad y economía para la mayoría de los casos.

¿Cómo actualizar Mealie a una nueva versión?

Para actualizar Mealie, ejecutado a través de Docker Compose, vaya al directorio ~/mealie. Luego ejecute docker compose pull para descargar las nuevas imágenes. Después de eso, ejecute docker compose up -d para recrear los contenedores con las nuevas imágenes. Antes de actualizar, siempre se recomienda revisar la documentación oficial de Mealie en GitHub, ya que puede haber cambios críticos o pasos de migración entre versiones principales.

Olvidé la contraseña de administrador de Mealie. ¿Cómo la restablezco?

En Mealie 2.x, puede restablecer la contraseña de administrador utilizando la utilidad de línea de comandos dentro del contenedor. Primero, encuentre el nombre o ID del contenedor de Mealie en ejecución: docker ps | grep mealie. Luego, ejecute el comando de restablecimiento de contraseña, reemplazando mealie-container-name con el nombre de su contenedor y new_password con la nueva contraseña deseada:

docker exec -it mealie-container-name python src/app/main.py users reset-password admin --new-password new_password
    

Asegúrese de usar el nombre de contenedor y el nombre de usuario correctos (admin por defecto).

¿Cómo cambiar el puerto en el que se ejecuta Mealie dentro de Docker?

Por defecto, Mealie escucha en el puerto 9000. Si necesita cambiar este puerto, puede editar el archivo docker-compose.yml. Busque el servicio mealie y cambie el puerto en el que escucha, ya sea en la sección ports o en la variable de entorno PORT en el archivo .env. Si cambia el puerto interno de Mealie, también deberá actualizar la configuración de Caddy (reverse_proxy mealie:NUEVO_PUERTO) para que apunte al nuevo puerto.

Conclusiones y próximos pasos

¡Felicidades! Ha instalado y configurado Mealie con éxito en su VPS, asegurando el acceso seguro a través de HTTPS e implementando una estrategia de copia de seguridad. Ahora tiene una herramienta potente y flexible para gestionar su colección de recetas, completamente bajo su control. Esto no solo organizará sus notas culinarias, sino que también le brindará una valiosa experiencia en la administración de servidores y la implementación de aplicaciones utilizando Docker.

Como próximos pasos, puede considerar:

• Configuración de monitoreo: Integre su VPS con sistemas de monitoreo, como Prometheus + Grafana, para rastrear el uso de recursos y el rendimiento de Mealie.
• Optimización del rendimiento: Si su colección de recetas crece significativamente, considere migrar a PostgreSQL para la base de datos, lo que puede mejorar el rendimiento en comparación con SQLite.
• Integración con otros servicios: Explore las posibilidades de integrar Mealie con otros servicios domésticos, como planificadores de tareas o asistentes inteligentes, para automatizar los procesos culinarios.
• Refuerzo de la seguridad: Agregue autenticación de dos factores para acceder a Mealie, si está disponible en futuras versiones, o considere configurar una VPN para acceder al VPS.