Guia de Configuracion de Coolify en VPS: Tu Propio Vercel

Coolify es un PaaS autoalojado que convierte tu VPS en una plataforma similar a Vercel/Netlify. Despliega aplicaciones desde Git, SSL automatico, despliegues sin tiempo de inactividad — todo en hardware que tu controlas.

Que es Coolify?

Coolify se encarga de la complejidad de la infraestructura:

• Integracion con Git — Push para desplegar
• SSL automatico — Let’s Encrypt integrado
• Multiples lenguajes — Node, Python, PHP, Go, Rust, sitios estaticos
• Bases de datos — PostgreSQL, MySQL, Redis, MongoDB con un clic
• Soporte Docker — Despliega cualquier Dockerfile
• Webhooks — Despliegues automaticos al hacer push

Piensa en ello como Heroku/Vercel autoalojado a una fraccion del costo.

Por que Coolify en vez de Vercel?

Factor	Vercel	Coolify en VPS
Costo (3 apps)	$60/mes+	$5-15/mes
Recursos	Limitados	VPS completo
Dependencia del proveedor	Alta	Ninguna
Arranques en frio	Si	No
Dominios personalizados	Limitados gratis	Ilimitados
Alojamiento de base de datos	Costo extra	Incluido

Punto de equilibrio: Si estas pagando mas de $20/mes en Vercel, Coolify te ahorra dinero.

Requisitos del VPS

Coolify necesita:

• Minimo: 2 vCPU, 2GB RAM, 30GB almacenamiento
• Recomendado: 4 vCPU, 4GB RAM, 50GB+ almacenamiento
• SO: Ubuntu 22.04+ o Debian 12+
• Puertos: 80, 443, 8000 (panel de control)

Proveedores de VPS Recomendados

Proveedor	Plan	Especificaciones	Precio
Hostinger	KVM1	1 vCPU, 4GB RAM	$4.99/mes
Hetzner	CX21	2 vCPU, 4GB RAM	€5.39/mes
Vultr	VC2	2 vCPU, 4GB RAM	$24/mes

Mejor relacion calidad-precio: Hostinger KVM1 — 4GB de RAM por $4.99 maneja de 5 a 10 aplicaciones facilmente.

Guia de Instalacion

Paso 1: Crea Tu VPS

Usando Hetzner como ejemplo:

1. Registrate en Hetzner Cloud
2. Crear Proyecto → Agregar Servidor
3. Selecciona: Ubuntu 22.04, CX21 (2 vCPU, 4GB RAM)
4. Agrega tu clave SSH
5. Crea el servidor, anota la IP

Paso 2: Configura Tu Dominio

Antes de instalar, configura el DNS:

A    coolify.tudominio.com    → ip-de-tu-servidor
A    *.coolify.tudominio.com  → ip-de-tu-servidor

El comodin es importante — cada aplicacion obtiene un subdominio.

Paso 3: Conecta y Prepara

ssh root@ip-de-tu-servidor

# Actualizar sistema
apt update && apt upgrade -y

# Establecer hostname (opcional pero recomendable)
hostnamectl set-hostname coolify

# Reiniciar para aplicar actualizaciones
reboot

Paso 4: Instala Coolify

Un solo comando instala todo:

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

Esto instala:

• Docker Engine
• Aplicacion Coolify
• Proxy inverso Traefik
• PostgreSQL para los datos de Coolify

La instalacion tarda de 2 a 5 minutos.

Paso 5: Accede al Panel de Control

Abre en el navegador:

http://ip-de-tu-servidor:8000

O si el DNS ya esta listo:

http://coolify.tudominio.com:8000

Crea tu cuenta de administrador en la primera visita.

Paso 6: Configura SSL

En el panel de control de Coolify:

1. Ve a Settings → Configuration
2. Establece tu Instance FQDN como https://coolify.tudominio.com
3. Activa Let’s Encrypt
4. Ingresa tu correo electronico para notificaciones SSL
5. Guarda y espera el certificado

Ahora accede via https://coolify.tudominio.com

Desplegando Tu Primera Aplicacion

Opcion A: Desde un Repositorio Git

1. Sources → Agregar GitHub/GitLab
2. Autoriza el acceso OAuth
3. Projects → Nuevo Proyecto → Nuevo Recurso
4. Selecciona Public Repository o tu cuenta conectada
5. Ingresa la URL del repositorio (ej., https://github.com/tu/app)
6. Coolify detecta automaticamente: Node, Python, PHP, estatico, Docker
7. Haz clic en Deploy

Coolify compila y despliega automaticamente. Obtienes una URL como: https://app-xxxx.coolify.tudominio.com

Opcion B: Usando Docker Compose

Para proyectos Docker existentes:

1. Projects → Nuevo Recurso → Docker Compose
2. Pega o enlaza tu archivo compose:

version: '3'
services:
  app:
    image: nginx:alpine
    ports:
      - 80:80

3. Despliega

Opcion C: Desplegar desde Dockerfile

1. Crear recurso → Dockerfile
2. Enlaza al repositorio que contiene el Dockerfile
3. Coolify compila y despliega

Despliegues Comunes

Aplicacion Next.js

# En Coolify:
# 1. Agrega fuente Git
# 2. Selecciona tu repositorio Next.js
# 3. Coolify detecta automaticamente Node, usa la salida de compilacion

Comando de compilacion: npm run build Comando de inicio: npm start

Python/FastAPI

# Dockerfile
FROM python:3.11-slim
WORKDIR /app
COPY requirements.txt .
RUN pip install -r requirements.txt
COPY . .
CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8000"]

Sitio Estatico

Solo apunta a un repositorio con index.html — Coolify lo sirve automaticamente.

WordPress

1. New Resource → Services → WordPress
2. Un clic despliega WordPress + MySQL
3. SSL y dominio se configuran automaticamente

Agregar Bases de Datos

PostgreSQL

1. Resources → Nuevo Recurso → PostgreSQL
2. Establece la contrasena
3. Despliega

La cadena de conexion aparece en el panel de control:

postgresql://user:password@postgres-xxxx:5432/postgres

Usala en tus aplicaciones mediante variables de entorno.

Redis

Mismo proceso:

1. Nuevo Recurso → Redis
2. Despliega
3. Usa redis://redis-xxxx:6379 en tus aplicaciones

MySQL/MariaDB

1. Nuevo Recurso → MySQL o MariaDB
2. Configura
3. Despliega

Despliegues Automaticos

Webhooks de GitHub

Coolify configura automaticamente los webhooks cuando conectas GitHub:

1. Haces push a la rama main
2. El webhook se activa
3. Coolify descarga, compila, despliega
4. Intercambio sin tiempo de inactividad

Activacion Manual

En cada aplicacion:

• Haz clic en Redeploy para activar manualmente
• Usa la API para integracion CI/CD:

curl -X POST https://coolify.tudominio.com/api/v1/deploy \
  -H "Authorization: Bearer TU_TOKEN_API" \
  -d '{"uuid": "app-uuid"}'

Variables de Entorno

Por Aplicacion

1. Abre la aplicacion en el panel de control
2. Pestana Environment Variables
3. Agrega pares clave-valor:

DATABASE_URL=postgresql://...
API_KEY=secret123
NODE_ENV=production

Compartidas Entre Aplicaciones

1. Projects → Selecciona el proyecto
2. Shared Variables
3. Estas se inyectan en todas las aplicaciones del proyecto

Dominios Personalizados

Agregar Dominio a una Aplicacion

1. Abre la aplicacion → Settings
2. Domains → Agregar dominio
3. Ingresa: app.tudominio.com
4. SSL se aprovisiona automaticamente

Multiples Dominios

Agrega tantos como necesites:

app.tudominio.com
www.tudominio.com
tudominio.com

Todos apuntan a la misma aplicacion.

Estrategia de Respaldo

Respaldos de Base de Datos

Coolify soporta respaldos programados:

1. Abre el recurso de base de datos
2. Backups → Activar
3. Establece el horario (diario recomendado)
4. Configura el destino S3/Minio

Datos de Aplicacion

Para aplicaciones con datos persistentes:

# En el VPS, respalda los volumenes Docker
docker run --rm -v app_data:/data -v /backup:/backup \
  alpine tar czf /backup/app-backup.tar.gz /data

Snapshots Completos del VPS

Usa la funcion de snapshots de tu proveedor:

• Hetzner: €0.012/GB/mes
• Hostinger: Incluido semanalmente
• Vultr: 20% del costo del VPS

Consejos de Rendimiento

1. Habilitar Swap

fallocate -l 2G /swapfile
chmod 600 /swapfile
mkswap /swapfile
swapon /swapfile
echo '/swapfile swap swap defaults 0 0' >> /etc/fstab

2. Limpiar Recursos Docker

# Limpieza semanal
docker system prune -a --volumes -f

O activalo en la configuracion de Coolify.

3. Monitorear Recursos

# Verificar estadisticas de contenedores
docker stats

El panel de control de Coolify muestra el uso de recursos por aplicacion.

4. Escalar Horizontalmente

Para aplicaciones con mucho trafico, agrega mas instancias VPS y usa la gestion de servidores de Coolify para distribuir los despliegues.

Solucion de Problemas

La Aplicacion No Se Despliega

# Verificar logs
docker logs coolify

# Verificar logs de compilacion en el panel de control
# Resources → App → Deployments → View logs

SSL No Funciona

1. Verifica que el DNS apunte correctamente
2. Espera la propagacion (hasta 24h)
3. Verifica que los puertos 80/443 esten abiertos en el firewall
4. Reinicia Traefik: docker restart coolify-proxy

Sin Espacio en Disco

# Verificar uso
df -h

# Limpiar Docker
docker system prune -a

# Eliminar despliegues antiguos en la configuracion de Coolify

Conexion a Base de Datos Rechazada

1. Asegurate de que el contenedor de la base de datos este en ejecucion
2. Usa el hostname interno de Docker (ej., postgres-xxxx)
3. Verifica las credenciales en el panel de control de Coolify

Coolify vs Alternativas

Plataforma	Complejidad	Mejor Para
Coolify	Baja	PaaS general, multiples aplicaciones
Dokploy	Baja	Similar a Coolify
CapRover	Media	Centrado en Docker
Portainer	Baja	Gestion de contenedores
Kubernetes	Alta	Gran escala

Coolify gana en simplicidad mientras ofrece suficiente potencia para la mayoria de los proyectos.

Preguntas Frecuentes

Cuantas aplicaciones puede ejecutar Coolify?

En un VPS de 4GB: de 5 a 15 aplicaciones ligeras. Mas con una gestion cuidadosa de recursos.

Esta Coolify listo para produccion?

Si, muchas empresas lo utilizan. La version v4 es estable y se mantiene activamente.

Puedo usar mi propio registro Docker?

Si, configuralo en Settings → Docker Registries.

Coolify soporta monorepos?

Si, especifica el subdirectorio que contiene tu aplicacion.

Como actualizo Coolify?

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

El mismo comando de instalacion actualiza a la ultima version.

Resumen

Coolify transforma un VPS de $5-15/mes en una plataforma de despliegue que rivaliza con Vercel/Netlify. Para desarrolladores y equipos pequenos, es el punto ideal entre Docker manual y PaaS costosos.

Configuracion Recomendada:

Componente	Eleccion	Costo
VPS	Hostinger KVM1	$4.99/mes
Plataforma	Coolify	Gratis
Dominios	Cloudflare	Gratis
Total		$4.99/mes

Comienza aqui: Hostinger VPS → Instala Coolify → Despliega aplicaciones.