Coolify v4.3 en un VPS: Gestiona tus apps sin PaaS gestionado

Heroku factura por dyno, Railway por hora de cómputo y por GB de ancho de banda de salida, Render por servicio activo. En cuanto un proyecto de cliente supera su plan gratuito — o el plan gratuito desaparece, como hizo Heroku en noviembre de 2022 — la factura sube por escalones. Para una agencia que gestiona entre ocho y quince aplicaciones, el acumulado supera rápidamente lo que costaría un VPS dedicado a la orquestación durante el año. El problema no es el precio de un proyecto aislado: es la multiplicación de líneas de facturación, cada una con su propio ciclo y sus propias reglas de exceso. A eso se suma el vendor lock-in: las variables de entorno, los add-ons de base de datos y los pipelines de despliegue son construcciones propietarias que habrá que migrar si la plataforma cambia sus tarifas o políticas. Coolify elimina todas esas líneas y las reemplaza por una sola: el VPS que aloja el orquestador.

Coolify orquesta Docker y puede ejecutar simultáneamente tus aplicaciones, bases de datos y su propio panel en el mismo servidor. Los recursos mínimos para empezar son 2 vCPU y 2 GB de RAM — suficiente para un puñado de servicios ligeros. En producción, con varios proyectos de clientes activos, planifica 4 GB de RAM: cada contenedor reserva su memoria, y las bases de datos (PostgreSQL, Redis, MySQL) consumen de forma constante. El almacenamiento depende de tus volúmenes: empieza con al menos 40 GB SSD, más si activas backups locales. Los puertos TCP 80 y 443 deben estar abiertos para Let's Encrypt y el tráfico de aplicaciones. El puerto 22 (SSH) es necesario para la instalación y la administración. Coolify no es compatible con un VPS donde Docker ya fue instalado manualmente con una configuración no estándar: parte de una imagen Ubuntu 22.04 LTS o Debian 12 limpia.

Coolify monitoriza la rama que designaste y lanza un nuevo despliegue en cada push mediante webhook. El ciclo completo — recepción del evento de GitHub/GitLab, construcción de la imagen, parada del contenedor anterior, arranque del nuevo — suele tardar menos de un minuto para una aplicación Node.js estándar. Las variables de entorno se gestionan como secretos cifrados en la base de datos de Coolify: nunca aparecen en texto claro en los logs. Para una aplicación que requiere una base de datos, crea primero el servicio de base de datos en el mismo proyecto Coolify (New Resource > Database), anota las credenciales generadas y añádelas como variables de entorno en la aplicación. Ambos servicios comparten automáticamente la misma red Docker interna.

Las previews de despliegue se activan desde la página de configuración de la aplicación, en la pestaña Preview Deployments. Una vez activado, cada pull request abierta en el repositorio recibe automáticamente un entorno efímero accesible en una URL construida sobre el patrón <pr-number>.<app-domain>. Coolify gestiona el certificado SSL de ese entorno mediante Let's Encrypt y destruye el entorno al cerrar o mergear la PR. Para los backups de volúmenes, ve a Storage > Backups en el nivel del servicio. Introduce las credenciales de un bucket compatible con S3 (AWS S3, Cloudflare R2, MinIO autoalojado), la frecuencia deseada (diaria, semanal) y el número de copias a retener. Coolify crea un archivo comprimido del volumen y lo transfiere al bucket según el calendario definido. Lanza la primera ejecución manualmente desde el panel para confirmar que las credenciales S3 funcionan antes de confiar en la automatización.

Cuatro situaciones aparecen con regularidad en las primeras instalaciones o tras una actualización.

Puerto 80 o 443 ya en uso. Coolify usa Traefik como reverse proxy en los puertos 80 y 443. Si otro proceso ocupa esos puertos (nginx, Apache instalado directamente en el VPS), Traefik no arranca y no se puede emitir ningún certificado. Comprueba con ss -tlnp | grep -E ':80|:443', detén el proceso competidor y luego reinicia Coolify con docker compose -f /data/coolify/source/docker-compose.yml restart.

Webhook de Git no disparado tras un push. La causa más frecuente es un cortafuegos de red que bloquea las IPs de salida de GitHub o GitLab hacia tu VPS. Verifica que los rangos de IP de GitHub Webhooks (https://api.github.com/meta) estén permitidos en el puerto 443 de tu VPS. Comprueba también en Coolify que el webhook se haya creado correctamente en la configuración del repositorio de GitHub (pestaña Webhooks del repositorio).

Certificado SSL bloqueado en espera. Let's Encrypt usa el desafío HTTP-01: intenta acceder a http://<tu-dominio>/.well-known/acme-challenge/. Si el DNS del dominio no se ha propagado aún, o si el puerto 80 no es accesible desde el exterior, el desafío falla y Traefik reintenta cada cinco minutos. Espera la propagación completa del DNS, verifica la accesibilidad del puerto 80 con curl -I http://<tu-dominio> y luego reinicia el servicio de la aplicación en Coolify.

Aplicación arrancada pero inaccesible. Verifica que el puerto expuesto en la configuración de Coolify corresponda al puerto en el que tu aplicación escucha realmente dentro del contenedor. Un contenedor Node.js que escucha en el 3000 debe tener 3000 como puerto de contenedor en la configuración de Coolify, aunque la URL pública use el puerto 443.

Coolify encaja dentro de un ecosistema de soluciones de despliegue autoalojadas. Si tu contexto requiere un enfoque diferente — pipelines GitOps mediante Kamal, orquestación ligera con Dokploy, o una interfaz simplificada con Easypanel — cada herramienta tiene sus puntos fuertes según el tamaño del equipo y la complejidad de los despliegues. Los artículos relacionados exploran estas alternativas y los casos de uso específicos de cada entorno.