Stack de n8n y Evolution API para Coolify
Versión 3.0 - Segura y Lista para Producción
Este repositorio contiene la configuración de Docker Compose para desplegar un stack completo y unificado con n8n y Evolution API, utilizando servicios compartidos de PostgreSQL y Redis.
Está diseñado para ser desplegado de forma robusta y segura en Coolify a través de su integración con Git.
Arquitectura Clave
Esta configuración utiliza un enfoque profesional para garantizar un despliegue estable:
-
Imagen de PostgreSQL Personalizada: Se usa un
Dockerfile.postgrespara construir una imagen propia de PostgreSQL que incluye el script de inicialización. Esto elimina por completo los errores de montaje de volúmenes. -
Sin Mapeo de Puertos: No se usa la sección
portspara dejar que el proxy de Coolify gestione el tráfico y los certificados SSL, evitando conflictos. -
Gestión de Secretos Centralizada: Todas las variables de entorno, especialmente los secretos, se gestionan exclusivamente en la interfaz de usuario de Coolify. Este repositorio no contiene ninguna contraseña o clave de API.
Estructura del Repositorio
/
|-- .gitignore
|-- .env.example <-- Plantilla de todas las variables necesarias. ¡NO CONTIENE SECRETOS!
|-- docker-compose.yaml <-- Orquesta los servicios y construye la imagen de Postgres.
|-- Dockerfile.postgres <-- Define cómo construir nuestra imagen de Postgres.
|-- init-db.sh <-- Script para crear la base de datos de Evolution.
`-- README.md <-- Esta guía.
Servicios
| Nombre del Servicio | Descripción | Accesible en |
|---|---|---|
n8n_app |
El servicio de automatización de flujos n8n. | https://flows.soul23.cloud (vía proxy Coolify) |
evolution_api |
La API de Evolution para la conexión con WA. | https://evo.soul23.cloud (vía proxy Coolify) |
pg_database |
Servidor PostgreSQL 16 compartido. | pg_database:5432 (red interna de Docker) |
redis_cache |
Servidor de caché Redis para Evolution. | redis_cache:6379 (red interna de Docker) |
Guía de Despliegue en Coolify
-
Pre-requisitos: Asegúrate de que tus registros DNS (
flows.soul23.cloudyevo.soul23.cloud) apunten a la IP de tu servidor Coolify. -
Configuración en Coolify:
- Crea una nueva Application desde este repositorio de Git.
- Build Pack:
Docker Compose - Base Directory:
/ - Docker Compose Location:
/docker-compose.yaml
-
Variables de Entorno (¡Importante!):
- Ve a la pestaña Environment Variables.
- Usa el archivo
.env.examplede este repositorio como plantilla para saber qué variables necesitas. - Añade las variables una por una o en modo "raw", reemplazando los valores de ejemplo con tus secretos reales. Nunca subas tus secretos a Git.
-
Dominios:
- Ve a la pestaña Domains y configura las rutas:
https://flows.soul23.cloud->n8n_app(puerto5678)https://evo.soul23.cloud->evolution_api(puerto8080)
- Ve a la pestaña Domains y configura las rutas:
-
Guardar y Desplegar:
- Guarda toda la configuración y haz clic en Deploy.
Solución de Problemas (Arranque en Frío)
Si un despliegue falla, el método más fiable es limpiar el estado anterior:
-
Stop la aplicación.
-
Ve a Persistent Storage y elimina todos los volúmenes.
-
Redeploy.