Saltar al contenido principal

Coolify: Despliega tus Apps con Docker sin ser DevOps (2026)

Guía práctica para montar Coolify en un VPS desde cero: instala el servidor, conecta tu repositorio y despliega con SSL automático. Sin saber Kubernetes ni DevOps avanzado.

Fran Cobos 7 min de lectura 1226 palabras

Tabla de contenidos

🎯 Lo que aprenderás en este artículo

  • Coolify abstrae Traefik y Docker Compose para que despliegues con un click
  • SSL automático con Let's Encrypt sin tocar nginx ni certbot
  • Cuesta ~5€/mes frente a los 20-40€/mes de Vercel/Railway para el mismo tráfico
  • El coste real no es el dinero: es la primera hora de configuración del servidor
  • Funciona con cualquier framework: Next.js, FastAPI, NestJS, Laravel...

Llevo usando Coolify en producción para dos proyectos propios. El resultado: pago ~5€/mes por el VPS y tengo 4 apps desplegadas con SSL automático, deploys automáticos al hacer push y monitorización básica.

Antes pagaba ~$40/mes entre Vercel Pro y Railway. El cambio mereció la pena.

Qué es Coolify (y qué no es)

Coolify no es un orquestador de contenedores como Kubernetes. Es una capa de abstracción sobre Docker y Traefik que te da una interfaz web para hacer lo que harías manualmente con docker-compose.yml y configuración de nginx.

Lo que hace por ti:

  • Genera y gestiona los docker-compose.yml automáticamente
  • Configura Traefik como reverse proxy con SSL Let’s Encrypt
  • Conecta con GitHub/GitLab para deploys automáticos en cada push
  • Gestiona variables de entorno de forma segura
  • Logs en tiempo real desde la interfaz
  • Deploy de bases de datos con 1 click (PostgreSQL, Redis, etc.)

Lo que NO hace:

  • Escalar horizontalmente entre varios servidores (para eso necesitas Kubernetes)
  • Gestionar clusters complejos
  • Sustituir un DevOps para aplicaciones con requisitos críticos de disponibilidad

Para un SaaS small/medium, para proyectos propios o para apps de clientes sin millones de usuarios: perfecto.


El servidor: qué necesitas

Cualquier VPS con Debian 12 o Ubuntu 22/24 LTS. Lo mínimo recomendado:

RecursoMínimoRecomendado
CPU1 vCPU2 vCPU
RAM2 GB4 GB
Disco20 GB40 GB SSD
OSDebian 12 / Ubuntu 22 LTSDebian 12

En Hetzner, el CX22 (2 vCPU, 4 GB RAM, 40 GB SSD) cuesta ~4.50€/mes. Es lo que uso para correr Coolify + 3 apps + 2 bases de datos.

Si quieres comparar costes reales de self-hosting vs plataformas como Vercel, lee Vercel vs VPS: Cuánto Cuesta Realmente una App Next.js.


Instalación paso a paso

1. Prepara el servidor (10 min)

Entra por SSH como root y crea un usuario no-root:

# Crear usuario
adduser francobosg
usermod -aG sudo francobosg

# Copiar SSH keys al nuevo usuario
rsync --archive --chown=francobosg:francobosg ~/.ssh /home/francobosg

# Desde ahora, usa este usuario

Configura el firewall básico:

ufw allow OpenSSH
ufw allow 80/tcp
ufw allow 443/tcp
ufw allow 8000/tcp   # Puerto de Coolify
ufw enable

2. Instala Docker

curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER
# Cierra y vuelve a abrir la sesión SSH

Verifica:

docker run hello-world
# Hello from Docker!

Si es tu primera vez con Docker, revisa Docker para Desarrolladores: Guía Práctica sin Teoría Innecesaria antes de continuar.

3. Instala Coolify (2 min)

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

Eso es todo. El script instala Docker si no lo tienes, configura Traefik como reverse proxy y arranca el panel de Coolify.

Abre http://TU_IP:8000 en el navegador. Verás el wizard de setup inicial.


Configuración inicial de Coolify

Cuenta de admin

En el wizard, crea tu cuenta de administrador. Email y contraseña robusta — esta es la única cuenta con acceso total.

Apunta tu dominio

Antes de configurar SSL necesitas:

  1. Un dominio (o subdominio) apuntando a la IP de tu servidor
  2. Esperar a que propague (5-60 min)

En Coolify: Settings → General → pon tu dominio en “Instance Domain”. Coolify generará automáticamente SSL para coolify.tudominio.com.

Conecta GitHub

Sources → Add → GitHub App

Coolify crea una GitHub App en tu cuenta con permisos mínimos (solo read de repos). Así puede hacer checkout del código y configurar webhooks para deploys automáticos.


Desplegar tu primera app

Ejemplo: API FastAPI

  1. New Project → New Resource → Application
  2. Selecciona el repo de GitHub
  3. Branch: main
  4. Build Pack: Dockerfile (o Nixpacks si no tienes Dockerfile)

Si tienes un Dockerfile en la raíz del repo:

FROM python:3.11-slim
WORKDIR /app
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
COPY . .
EXPOSE 8080
CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8080"]

Coolify detecta el puerto expuesto (8080) y configura el reverse proxy automáticamente.

  1. Domain: api.tudominio.com — Coolify genera el certificado SSL solo
  2. Variables de entorno: añade DATABASE_URL, SECRET_KEY, etc. de forma segura
  3. Deploy — el primer deploy tarda 2-3 min (build de la imagen)

Desde ese momento, cada git push a main dispara un deploy automático.

Desplegar PostgreSQL

No instales PostgreSQL directamente en el servidor. Usa el servicio de Coolify:

New Resource → Database → PostgreSQL

Coolify levanta un contenedor PostgreSQL con:

  • Contraseña generada automáticamente
  • Volumen persistente para datos
  • Red interna de Docker (no expuesta al exterior por defecto)

Copia la connection string interna (postgresql://user:pass@postgres:5432/db) y pégala en las variables de entorno de tu app.


Deploys automáticos y rollback

Coolify guarda las últimas N builds. Si un deploy rompe algo:

  1. Panel de la app → Deployments
  2. Elige una build anterior
  3. Redeploy — vuelves al estado anterior en 30 segundos

Para deploys en ramas de feature antes de mergear a main:

# En Coolify: configurar Preview Deployments
# Cada PR genera una URL temporal: pr-123.tudominio.com

Monitorización básica

Coolify incluye monitorización básica out of the box:

  • Logs: streaming en tiempo real de cada contenedor
  • Métricas: CPU y RAM del servidor (gráfica simple)
  • Health checks: reinicia el contenedor automáticamente si falla

Para monitorización avanzada puedes conectar Prometheus + Grafana como servicio adicional en Coolify, o usar Plausible (que también se despliega en Coolify) para métricas de usuario.


Lo que aprendí usándolo en producción

1. El primer setup tarda más de lo que dicen. El script de instalación son 5 min, pero preparar el servidor, configurar el DNS, crear la GitHub App y hacer el primer deploy bien configurado son fácilmente 2-3 horas la primera vez.

2. Usa dominios internos para las bases de datos. PostgreSQL y Redis no deben estar expuestos con dominio público. La connection string interna de Docker (postgres:5432) es más rápida y segura.

3. Los volumes de Docker son tu backup. Los datos de las BDs están en volumes de Docker. Haz snapshots del VPS periódicamente o configura backups automáticos en Coolify.

4. Nixpacks es magia para apps sin Dockerfile. Para un proyecto Next.js o FastAPI sin Dockerfile, Nixpacks detecta el framework y construye la imagen automáticamente. Funciona el 90% de las veces.

5. Coolify no reemplaza conocer Docker. Si algo falla, necesitas saber qué es un contenedor, cómo ver logs y qué hace un docker-compose.yml. No entres en producción sin haber leído antes Docker para Desarrolladores.


¿Cuándo no usar Coolify?

  • Alta disponibilidad real (99.99% uptime): necesitas Kubernetes + múltiples nodos
  • Equipo de DevOps dedicado: probablemente ya tienen su stack
  • Apps con requisitos de compliance estrictos (PCI-DSS, HIPAA): los managed services tienen certificaciones que tú tendrías que conseguir solo

Para todo lo demás — proyectos propios, SaaS small, apps de clientes, prototipos en producción — Coolify es la mejor relación calidad/precio que he encontrado.


Recursos

Fran Cobos

Fran Cobos

Desarrollador Full Stack especializado en IA aplicada, automatización y desarrollo web. Escribo sobre herramientas, tutoriales y casos reales para programadores.

¿Necesitas desarrollo a medida?

Apps web, IA, módulos ERP — cuéntame tu proyecto.