Tutoriales de VPS
Mautic en un VPS: Docker, SMTP, campañas y copias
Despliega Mautic con Docker, una base soportada y Caddy. Configura roles web, cron y worker, campañas, SMTP, consentimiento y seguimiento; verifica copias coherentes, recuperación y actualizaciones.

Mautic reúne contactos, segmentos, campañas, formularios y seguimiento en una plataforma de marketing propia. Controlas la instalación y las reglas, pero también mantienes base de datos, tareas programadas, reputación del correo y recuperación. Al comparar con SaaS, cuenta VPS, proveedor de correo y mantenimiento.
Usaremos Ubuntu 24.04, Docker Compose, una base compatible con MySQL y Caddy. Las imágenes oficiales desde Mautic 5 separan web, cron y workers. Elige una versión soportada y sus ejemplos completos; una receta antigua de un solo contenedor no equivale a esa arquitectura.
| Recurso | Pruebas | Referencia para un equipo pequeño |
|---|---|---|
| CPU | 2 vCPU | 4 vCPU o más |
| RAM | 2 GB | 4 GB o más |
| Disco | 30 GB SSD | 60 GB SSD o más |
| Sistema | Ubuntu 22.04/24.04 | Ubuntu 24.04 LTS |
| Dominio | mautic.example.com | Subdominio de marketing |
Son presupuestos iniciales, sin garantía de capacidad. Importaciones, campañas, informes y workers consumen más que la interfaz web. Revisa free -h, df -h y docker stats; consulta dimensionamiento. Configura A/AAAA funcionales, deja la base privada y abre solo administración necesaria y 80/443 públicos en el firewall del proveedor.
sudo apt update
sudo apt install -y ca-certificates curl openssl
curl -fsSL https://get.docker.com | sudo sh
sudo usermod -aG docker "$USER"
newgrp docker
sudo mkdir -p /opt/mautic
sudo chown -R "$USER":"$USER" /opt/mautic
cd /opt/mautic
Revisa el instalador ejecutado como root o usa paquetes soportados. El grupo Docker concede acceso potente al anfitrión.
openssl rand -hex 32
openssl rand -base64 32
Genera credenciales independientes y los secretos que exija la versión. Guarda valores reales en archivos protegidos, fuera de repositorios públicos.
El esquema antiguo muestra base y puerto web privado. No lo uses sin cambios con imágenes actuales: MAUTIC_DB_NAME y MAUTIC_RUN_CRON_JOBS no sustituyen la variable documentada ni los roles actuales. Montar todo /var/www/html también puede ocultar o conservar código entre actualizaciones.
services:
db:
image: mariadb:10.11
restart: unless-stopped
command: --character-set-server=utf8mb4 --collation-server=utf8mb4_unicode_ci
environment:
MYSQL_DATABASE: mautic
MYSQL_USER: mautic
MYSQL_PASSWORD: change-a-long-password
MYSQL_ROOT_PASSWORD: change-a-root-password
volumes:
- db_data:/var/lib/mysql
healthcheck:
test: ["CMD", "healthcheck.sh", "--connect", "--innodb_initialized"]
interval: 10s
timeout: 5s
retries: 15
mautic:
image: mautic/mautic:latest
restart: unless-stopped
depends_on:
db:
condition: service_healthy
environment:
MAUTIC_DB_HOST: db
MAUTIC_DB_NAME: mautic
MAUTIC_DB_USER: mautic
MAUTIC_DB_PASSWORD: change-a-long-password
MAUTIC_RUN_CRON_JOBS: "false"
ports:
- "127.0.0.1:8080:80"
volumes:
- mautic_data:/var/www/html
volumes:
db_data:
mautic_data:
Parte del ejemplo básico oficial:
- Descarga el ejemplo junto con .env y .mautic_env en un directorio propio y registra la revisión.
- En .env, configura MYSQL_DATABASE, MYSQL_USER, MYSQL_PASSWORD y MYSQL_ROOT_PASSWORD. Elige una base admitida por esa versión; el ejemplo actual usa MySQL y no garantiza cualquier MariaDB.
- En .mautic_env, define MAUTIC_DB_HOST=db, MAUTIC_DB_DATABASE y MAUTIC_DB_USER/MAUTIC_DB_PASSWORD coherentes. Los tres servicios comparten configuración y credenciales.
- Fija los tres servicios a la misma etiqueta Apache soportada. La nomenclatura documentada incluye 6.0.6-apache; verifica tu publicación elegida. Los mantenedores desaconsejan su ejemplo FPM/Nginx sin conocimientos de esa configuración.
- Conserva mautic_web, mautic_cron y mautic_worker. Los dos últimos usan DOCKER_MAUTIC_ROLE=mautic_cron y mautic_worker. Define DOCKER_MAUTIC_LOAD_TEST_DATA=false.
- Publica la web como 127.0.0.1:8080:80. Conserva config, var/logs y docroot/media files/images para todos los roles, con propietario y escritura correctos. No publiques la base.
Los comandos antiguos asumen un servicio mautic; adapta ese nombre a la plantilla:
docker compose config
docker compose pull
docker compose up -d
docker compose ps
docker compose logs --tail=150 mautic
En el directorio de la plantilla actual:
docker compose config --quiet
docker compose pull
docker compose up -d
docker compose ps
docker compose logs --tail=100 mautic_web mautic_cron mautic_worker
Una web disponible no demuestra funcionamiento de cron o colas. La configuración expandida puede mostrar contraseñas; protege esa salida.
ssh -L 8080:127.0.0.1:8080 root@SERVER_IP
Abre http://127.0.0.1:8080 desde tu ordenador a través del túnel. En esa red, el host de base es db, no localhost. Prueba las URL públicas en el hostname HTTPS final.
- Configura identidad, zona horaria e idioma.
- Usa una contraseña administrativa fuerte y MFA cuando la edición lo admita.
- Configura remitente y nombre visible.
- Define URL de formularios, páginas y seguimiento.
- Crea un contacto y campaña de prueba.
- Verifica aperturas, clics, bajas y errores con destinatarios de prueba; la protección de privacidad puede volver poco fiable la medición de aperturas.
sudo apt install -y caddy
sudo nano /etc/caddy/Caddyfile
mautic.example.com {
encode gzip zstd
reverse_proxy 127.0.0.1:8080
header {
Strict-Transport-Security "max-age=31536000; includeSubDomains"
X-Content-Type-Options "nosniff"
X-Frame-Options "SAMEORIGIN"
}
}
sudo caddy validate --config /etc/caddy/Caddyfile
sudo systemctl reload caddy
curl -I https://mautic.example.com
Una sola puerta de entrada ocupa 80/443 y reenvía a 8080 privado. Ajusta URL pública y proxies de confianza. HSTS/includeSubDomains exige HTTPS en los nombres afectados. Consulta Caddy.
Elige un proveedor que permita explícitamente tus campañas; un relay transaccional no admite necesariamente marketing. Evita contraseñas normales de correo personal.
- Usa un subdominio remitente, por ejemplo mail.example.com.
- Configura SPF, DKIM y DMARC según el proveedor.
- Verifica PTR de la IP SMTP que realmente envía; si usas relay, normalmente lo gestiona su proveedor, no tu VPS.
- Incluye un mecanismo de baja claro y funcional.
- Empieza con lotes pequeños y consentimiento, respetando límites de envío.
- Vigila rebotes definitivos, quejas y bajas; suprime direcciones inválidas o dadas de baja.
Envía una prueba directa y otra desde una campaña. Examina autenticación, registros, rebotes y spam antes de aumentar concurrencia.
Para imágenes actuales, empieza con roles oficiales cron y worker. Si decides programar comandos en el anfitrión, inspecciona la CLI instalada y ejecuta primero cada tarea con el usuario de la aplicación.
crontab -e
Este horario antiguo ilustra periodicidad, pero no constituye una cadena completa actual:
*/5 * * * * cd /opt/mautic && docker compose exec -T mautic php bin/console mautic:campaigns:trigger --no-interaction >/dev/null 2>&1
*/10 * * * * cd /opt/mautic && docker compose exec -T mautic php bin/console mautic:segments:update --no-interaction >/dev/null 2>&1
*/5 * * * * cd /opt/mautic && docker compose exec -T mautic php bin/console mautic:emails:send --no-interaction >/dev/null 2>&1
Actualizar segmentos, incorporar/actualizar contactos de campaña y disparar eventos son etapas distintas. Comprueba requisitos y orden de mautic:segments:update, mautic:campaigns:update y mautic:campaigns:trigger. Los comandos antiguos de correo pueden diferir de workers Messenger. Utiliza list y los archivos cron de la versión; cuando corresponda, ejecuta como www-data en /var/www/html.
- Elige un único responsable del horario: rol cron o tareas propias del anfitrión.
- Evita solapamientos con bloqueos y límites de procesamiento.
- Separa tareas dependientes y mide su duración antes de reducir intervalos.
- Conserva registros protegidos y alertas de error; no descartes toda la salida.
- Usa workers para transportes asíncronos y vigila acumulación de colas por separado.
- Explica finalidad, cookies y retención.
- Pide solo campos necesarios.
- Registra consentimiento de marketing separado de avisos de servicio.
- Prepara un proceso de acceso, exportación y eliminación de datos.
- No incluyas API keys ni credenciales SMTP/base en el navegador.
- Usa HTTPS y verifica CORS y cabeceras.
Aplica las normas correspondientes a las personas cuyos datos tratas, incluidas las regionales sobre consentimiento y seguimiento. En Cloudflare, evita caché para sesiones, formularios y respuestas personalizadas; no reutilices la respuesta de un contacto para otro.
Este ejemplo antiguo supone un cliente MariaDB y un volumen concreto:
mkdir -p /opt/mautic/backups
docker compose exec -T db mysqldump -umautic -p"YOUR_DB_PASSWORD" mautic | gzip > /opt/mautic/backups/mautic-$(date +%F).sql.gz
docker run --rm -v mautic_mautic_data:/data -v /opt/mautic/backups:/backup alpine sh -c 'tar czf /backup/mautic-data-$(date +%F).tgz -C /data .'
cp .env docker-compose.yml /opt/mautic/backups/
Usa el cliente admitido por tu base y credenciales protegidas. Activa pipefail y verifica la exportación. Inspecciona montajes reales, sin adivinar prefijos Compose. En el modelo actual guarda base, config, media, .env, .mautic_env, Compose y versiones; los logs también ayudan. Detén escrituras y workers para un punto coherente y copias físicas.
Conserva copias externas cifradas. Restaura la misma versión en una máquina limpia y prueba administrador, contactos, formularios, campañas, plantillas y bajas. Desactiva envíos/seguimiento o usa destinatarios de prueba para no repetir campañas. Consulta restauración probada.
docker compose config > /opt/mautic/backups/compose-$(date +%F).yaml
docker compose pull
docker compose up -d
docker compose ps
docker compose logs --tail=200 mautic
Fija versiones anterior/nueva, copia primero y prueba migraciones. No sigas latest automáticamente. Una base migrada puede requerir restaurar la copia anterior para volver atrás; cambiar solo la imagen no basta.
docker compose ps
docker compose logs --tail=200 mautic
sudo journalctl -u caddy -n 100 --no-pager
ss -lntp | grep -E ':8080|:80|:443'
En la plantilla actual revisa mautic_web. Comprueba 8080 privado, upstream, URL final, proxy de confianza y cookies HTTPS.
Ejecuta el comando manualmente y revisa código de salida, responsable cron, permisos Docker, usuario, actualización de campañas, bloqueos y colas. Reducir el intervalo no repara un comando fallido.
Busca schedulers duplicados, consumidores con configuración diferente, límites del proveedor, rebotes y quejas. Exporta datos de auditoría antes de eliminar contactos y conserva bajas.
- Dominio, HTTPS, login y formularios funcionan.
- SMTP, SPF, DKIM, DMARC y PTR del remitente verificados.
- Segmentos, campañas y colas funcionan con supervisión.
- Base y puertos internos privados; administración con acceso controlado.
- Configuración, base y media con copia externa cifrada.
- Restauración segura en una instancia separada completada.
- Versiones, migraciones y reversión documentadas.
Empieza con una audiencia pequeña y valida el recorrido completo desde el consentimiento hasta la baja antes de ampliar campañas.