Cómo instalar Coolify en Docker (guía paso a paso 2026)

Actualizado: 2026-05-16

Coolify 4.x es una plataforma de despliegue autohospedada que gestiona aplicaciones Git, bases de datos y certificados SSL desde un dashboard web, sobre Docker. Un script oficial levanta la instalación completa en 2-5 minutos sobre Ubuntu 24.04 o Debian 13. Esta guía cubre la instalación, la configuración de dominio con TLS, el primer despliegue desde Git y los backups.

Puntos clave

• El script oficial instala Docker y arranca Coolify 4.x en 2-5 minutos.
• Gestiona PostgreSQL, MySQL/MariaDB, MongoDB, Redis y ClickHouse con persistencia y backups a S3.
• Traefik integrado emite certificados Let’s Encrypt sin configuración adicional.
• Funciona bien para proyectos personales, startups y agencias con control total sobre la infraestructura.
• No cubre multi-región nativo ni edge functions distribuidas.

Requisitos

• Ubuntu 24.04 LTS o Debian 13 (Trixie), mínimo 2 GB de RAM y 40 GB de disco.
• Acceso sudo o root al servidor.
• Dominio apuntando al servidor (opcional para pruebas, obligatorio en producción).
• Puertos 80, 443 y 8000 abiertos.

Si aún no tienes Docker en el servidor, consulta primero cómo instalar Docker en Ubuntu 24.04 o cómo instalar Docker en Debian 12.

Instalación con el script oficial

Coolify distribuye un script que instala Docker si no está presente, descarga los contenedores base y configura la red interna. En el servidor como root:

curl -fsSL https://cdn.coollabs.io/coolify/install.sh | bash

El script realiza tres pasos:

1. Instala Docker Engine y Docker Compose v2 si el servidor no los tiene.
2. Descarga las imágenes de Coolify 4.x y sus dependencias (proxy Traefik, base de datos interna).
3. Arranca los contenedores y configura la red interna coolify.

Tarda entre 2 y 5 minutos según la velocidad de descarga del servidor. El código fuente del script está en el repositorio oficial de Coolify en GitHub^[1].

Dashboard de Coolify 4.x tras la instalación. El servidor “localhost” aparece listo para desplegar.

Primer acceso

Una vez termina el script, abre el navegador en:

http://<IP-del-servidor>:8000

Coolify pide crear el usuario administrador en la primera carga. Tras el registro, el dashboard muestra un servidor “localhost” ya configurado y listo para desplegar aplicaciones.

Configurar dominio y TLS

Para producción, el flujo en Settings → Server es:

1. Configura el hostname con el dominio que apunta al servidor.
2. Coolify usa Traefik^[2] como ingress interno, la misma herramienta que usamos en jacar.es para gestionar el tráfico entre contenedores, ver cómo instalar Traefik con Docker Compose.
3. Los certificados Let’s Encrypt se emiten en el primer request al dominio.

Panel SSL de Coolify 4.x. El certificado Let’s Encrypt se emite automáticamente sin configuración adicional.

Primer despliegue desde Git

En el dashboard:

1. Projects → New Project, asigna un nombre.
2. Add Resource → Application → elige “Git repository”.
3. Conecta GitHub, GitLab o Gitea mediante OAuth o token personal.
4. Selecciona el repositorio y la rama.
5. Coolify detecta el framework (Next.js, Nuxt, Astro, Node.js, Python, PHP, etc.) y propone la configuración de build.
6. Añade las variables de entorno necesarias.
7. Pulsa Deploy.

En menos de tres minutos la aplicación está en <slug>.<dominio> con HTTPS automático.

Logs de despliegue en tiempo real. Coolify muestra cada paso del build y la URL final una vez el contenedor arranca.

Bases de datos gestionadas

Coolify crea y gestiona contenedores de base de datos con persistencia en volúmenes Docker:

• PostgreSQL
• MySQL/MariaDB
• MongoDB
• Redis
• ClickHouse

Add Resource → Database crea el contenedor con almacenamiento persistente. Las credenciales son inyectables directamente en las variables de entorno de las aplicaciones del mismo proyecto. Los backups a cualquier bucket S3-compatible (Hetzner Object Storage, Backblaze B2, Cloudflare R2) se activan por política desde la misma interfaz.

Panel de base de datos. Coolify muestra el string de conexión listo para copiar e inyectar en la aplicación.

Backups y mantenimiento

Hay dos niveles de backup independientes:

• Instancia de Coolify: Settings → Backup configura la copia de la propia configuración de Coolify, incluidos metadatos de proyectos y recursos.
• Bases de datos: cada base de datos tiene su política de backup independiente hacia un bucket S3-compatible.

Las actualizaciones de Coolify se aplican desde Settings → Updates. Coolify actualiza sus propios contenedores sin detener las aplicaciones desplegadas.

Configuración de backups. Coolify permite programar copias de la instancia y de cada base de datos a cualquier proveedor S3.

Cuándo usar Coolify

Encaja bien si:

• Tienes un VPS y quieres reemplazar despliegues manuales por un dashboard.
• Necesitas alojar varias aplicaciones con bases de datos en el mismo servidor.
• Quieres evitar el coste variable de plataformas como Vercel o Railway a partir de cierto tráfico.
• Gestionas infraestructura para clientes y necesitas aislar proyectos.

No encaja si necesitas multi-región nativo, edge functions distribuidas o certificaciones de cumplimiento regulatorio estricto (SOC 2, HIPAA, etc.).

Para comparar con otras herramientas de seguridad de contenedores que se integran bien con este stack, consulta Trivy y Grype para escaneo de imágenes Docker en CI.

Sobre Coolify 4.x frente a versiones anteriores

La versión 4 reescribió el núcleo respecto a la serie 3. Los proyectos v3 no migran automáticamente: hay que recrear los recursos en v4. La interfaz es más estable y el modelo de datos más limpio, pero si vienes de v3 planifica el tiempo de migración. La documentación oficial de Coolify^[3] mantiene la guía de migración actualizada.

Preguntas frecuentes

¿Coolify es una alternativa real a Vercel o Heroku?

Sí para proyectos sin requisitos de edge computing. Coolify replica el flujo de despliegue desde Git con preview URLs, variables de entorno y bases de datos gestionadas. La diferencia es que corres la plataforma en tu propio servidor y pagas el VPS en lugar de por uso. Para un proyecto con tráfico moderado y un VPS de 4 GB de RAM, el coste mensual es sensiblemente inferior al de Vercel Pro.

¿Cuántos recursos mínimos necesita el VPS?

La instalación base de Coolify 4.x ocupa alrededor de 500 MB de RAM en reposo. Con una o dos aplicaciones ligeras desplegadas, 2 GB de RAM y 2 vCPUs son suficientes. Para producción con varias aplicaciones y bases de datos activas, 4 GB de RAM es más cómodo.

¿Soporta despliegues desde GitHub Actions?

Sí. Coolify expone webhooks por proyecto que GitHub Actions puede llamar al final de un workflow. El patrón habitual es que Actions construya y empuje la imagen al registry, y el webhook de Coolify fuerce el redeploy con la nueva imagen.

¿Cómo se migra de Coolify v3 a v4?

La migración no es automática. El proceso oficial consiste en exportar la configuración de v3, instalar v4 en limpio y recrear los recursos manualmente. Coolify mantiene la guía de migración en su documentación oficial. Planifica una ventana de mantenimiento de 1-2 horas dependiendo de cuántos proyectos tengas.

¿Cuánto cuesta Coolify?

La edición open source (self-hosted) es gratuita. Existe una edición cloud gestionada por el equipo de Coolify con planes de pago que parten de unos 5 USD al mes por servidor gestionado. El código fuente está en GitHub bajo licencia Apache 2.0.

¿En qué se diferencia de CapRover, Dokku o Portainer?

Dokku es más minimalista y requiere configuración por línea de comandos. CapRover tiene una curva de aprendizaje similar a Coolify pero menos actividad de desarrollo reciente. Portainer gestiona contenedores Docker directamente pero no tiene el concepto de “proyecto con base de datos y SSL automático”. Coolify apunta al mismo nicho que CapRover pero con una interfaz más pulida y desarrollo activo en 2025-2026.

¿Funciona con Cloudflare Tunnel?

Sí. Se puede poner Coolify detrás de un Cloudflare Tunnel en lugar de exponer el puerto 443 directamente. En ese caso hay que desactivar el modo “Full (strict)” de Cloudflare para los certificados de origen, o usar un certificado de origen de Cloudflare en lugar de Let’s Encrypt. El tutorial oficial de Coolify documenta este flujo.

¿Los backups incluyen los volúmenes de datos de las aplicaciones?

No por defecto. Los backups de instancia cubren la configuración de Coolify. Los backups de base de datos cubren los dumps SQL de las bases de datos gestionadas. Los volúmenes de datos de las aplicaciones (ficheros subidos, assets, etc.) hay que respaldarlos por separado con rsync o una herramienta de snapshots del proveedor de VPS.

¿Se puede usar Docker Compose propio dentro de Coolify?

Sí. Coolify acepta ficheros docker-compose.yml como tipo de recurso. Puedes desplegar un stack Compose completo con varios servicios y Coolify gestiona el ciclo de vida, el dominio y el SSL igual que con aplicaciones Git normales.

¿Qué pasa si el servidor se reinicia?

Coolify configura los contenedores con restart: unless-stopped. Tras un reinicio del servidor, Docker arranca automáticamente y Coolify y todas las aplicaciones vuelven a estar disponibles sin intervención manual.

1. repositorio oficial de Coolify en GitHub
2. Traefik
3. documentación oficial de Coolify