Coolify (Plataforma PaaS Autohospedada)

1. Visión general del concepto y problema sistémico

Las plataformas PaaS en la nube (Vercel, Heroku, Netlify, Render) han proporcionado a los desarrolladores un nivel de comodidad sin precedentes: un simple git push compila automáticamente el proyecto, asigna un dominio, conecta SSL y despliega el servicio. Sin embargo, por esta comodidad, las empresas enfrentan una carga financiera y restricciones arquitectónicas severas:

• Facturación abusiva: el costo del tráfico en la nube es de 10 a 20 veces superior al del mercado, y las facturas por exceder límites pueden alcanzar miles de dólares.
• Timeouts sin servidor: el límite en la ejecución de funciones (15–60 segundos) imposibilita la ejecución de ciclos de agentes autónomos, scraping complejo o reflexiones prolongadas de modelos de lenguaje.
• Bloqueo de proveedor: optimizaciones específicas dificultan la migración del código a hardware propio.

Coolify ofrece lo mejor de ambos mundos: la experiencia de Vercel en un servidor propio por un costo de $5–$20 al mes. Es un sistema de gestión de servidores de código abierto (Self-Hosted PaaS) que se instala con un solo comando, se conecta a repositorios de GitHub/GitLab y se encarga de todo el ciclo de construcción, enrutamiento de tráfico y administración de bases de datos.

2. Taxonomía arquitectónica y modelo mental

El marco arquitectónico de Coolify se basa en la orquestación del demonio de Docker y un proxy dinámico:

┌─────────────────────────────────────────────────────────────┐
│                    ARQUITECTURA DEL HOST COOLIFY            │
├─────────────────────────────────────────────────────────────┤
│ 1. Proxy Inverso Dinámico (Motor Traefik v3)                │
│    • Enrutamiento automático de puertos a través de Docker Labels│
│    • Certificados SSL automáticos de Let's Encrypt (ACME)    │
├─────────────────────────────────────────────────────────────┤
│ 2. Plano de Control de Coolify (API Laravel y UI Web en Vivo)│
│    • Gestor de Webhooks de GitHub / GitLab                   │
│    • Gestión de variables de entorno (cifrado .env)          │
├─────────────────────────────────────────────────────────────┤
│ 3. Motor de Construcción Poliglota:                          │
│    • Nixpacks (Detección automática de lenguajes: Node, Bun, Python, Go)│
│    • Constructor de Dockerfile / Docker Compose              │
├─────────────────────────────────────────────────────────────┤
│ 4. Almacenamientos y Bases de Datos Gestionados (Postgres, Redis, S3 Backup)│
└─────────────────────────────────────────────────────────────┘

1. Proxy inverso dinámico (Motor Traefik):
   • Gestor central del tráfico entrante. Escucha constantemente el socket de Docker: cuando se levanta un nuevo contenedor con etiquetas de dominio, Traefik lo detecta instantáneamente, emite un certificado SSL y comienza a dirigir las solicitudes HTTP/HTTPS sin reiniciar el proxy.
2. Motor de construcción poliglota (Nixpacks y Docker):
   • Permite la construcción de código sin necesidad de escribir manualmente complejos Dockerfile. Nixpacks detecta automáticamente la versión de Node.js, instala dependencias a través de pnpm y genera un contenedor mínimo.
3. Gestión de datos con un clic (Bases de Datos Gestionadas):
   • Despliegue de instancias de producción de PostgreSQL, Redis, MySQL, ClickHouse o MinIO con copias de seguridad cifradas automáticas en almacenamiento en la nube S3 (AWS o Cloudflare R2) programadas.
4. Aislamiento de entornos (Despliegues de Vista Previa):
   • Levantamiento automático de copias efímeras del servicio para cada Pull Request abierto en subdominios temporales.

3. Pipeline técnico y mecánica interna

El ciclo de vida del despliegue continuo (GitOps Lifecycle) en Coolify:

1. Commit de código y webhook: Un ingeniero realiza git push origin main. GitHub envía un webhook HMAC firmado a la API de Coolify.
2. Validación y ejecución del trabajador: Coolify verifica la firma de seguridad, descarga el último commit según el hash SHA especificado y lanza un contenedor de construcción aislado.
3. Fase de compilación (Construcción Nixpacks): Se instalan dependencias, se ejecuta la construcción de la aplicación (npm run build). Se crea una imagen Docker optimizada.
4. Cambio suave de tráfico (Despliegue Rolling):
   • Se levanta un nuevo contenedor con la aplicación en un nuevo puerto interno.
   • Traefik verifica el estado de salud (Health Check).
   • Una vez que el nuevo contenedor responde con HTTP 200, el proxy cambia el tráfico y el contenedor antiguo se detiene (Zero-Downtime Swap).
5. Alertas y notificaciones: El estado del despliegue exitoso se envía al ingeniero en Telegram o Discord con un enlace al commit.

4. Escenarios prácticos de ingeniería en producción

01. Despliegue de una plataforma Full-Stack Next.js 15 en un servidor por $10

Lanzamiento completo de un SaaS comercial en un VPS en Hetzner:

• Coolify compila el frontend de Next.js, levanta una base de datos PostgreSQL y Redis para el almacenamiento en caché de sesiones.
• El tráfico pasa a través de Traefik integrado con soporte para HTTP/2 y SSL.
• El servicio soporta un millón de vistas al mes sin costos adicionales en la nube.

02. Alojamiento de agentes AI de larga duración sin timeouts

Despliegue de procesos backend complejos (LangGraph, scraping automático):

• En Vercel, la solicitud se corta después de 60 segundos.
• En Coolify, el agente puede funcionar de manera autónoma durante 4 horas seguidas en un contenedor en segundo plano, manteniendo conexiones WebSockets abiertas con el cliente.

03. Creación de entornos de vista previa temporales (PR Previews)

Organización de una revisión cómoda para el equipo:

• Al abrir el PR #87, Coolify levanta automáticamente la aplicación en la dirección pr-87.gotburnout.dev.
• El tester verifica la funcionalidad en vivo antes de fusionar en la rama principal, después de lo cual el contenedor se elimina automáticamente al cerrar el PR.

5. Errores comunes, trampas y seguridad

• Caídas del servidor por desbordamiento de memoria (Build OOM): La construcción de proyectos frontend modernos en Next.js puede consumir hasta 3–4 GB de RAM durante la optimización de bundles. En servidores con 2 GB de RAM, asegúrate de crear un archivo de intercambio (swapfile) de al menos 4 GB.
• Dejar el panel de control abierto a escaneadores: Por defecto, la interfaz de Coolify opera en el puerto 8000. Asegúrate de protegerlo con tu propio dominio con autenticación de dos factores (2FA) forzada, o ciérralo con un firewall UFW, permitiendo tráfico solo a través de Tailscale/VPN.
• Desbordamiento del espacio en disco por imágenes Docker antiguas: Un despliegue diario crea decenas de capas compiladas. Si no habilitas la limpieza automática (Docker Cleanup Scheduler), el disco se llenará en unas pocas semanas.
• Almacenamiento de contraseñas de bases de datos en archivos no seguros: Utiliza el gestor de secretos integrado de Coolify para inyectar variables de entorno en lugar de comprometer archivos .env en el repositorio.