Durante mucho tiempo, Coolify fue una idea interesante con asperezas, eternamente en beta. Eso cambió en abril de 2026, cuando por fin salió la v4.0.0 estable, seguida casi de inmediato por la v4.1.0 en mayo con builds con Railpack, registros de auditoría y un servidor MCP que se integra con Claude Code. En ese momento dejó de ser un "proyecto prometedor" y pasó a ser algo que vale la pena correr en producción en un homelab.
Si has estado pagando facturas de nube a Heroku, Render o Railway para desplegar proyectos personales y herramientas internas, este artículo es para ti. Coolify te da el mismo flujo de "git push", SSL automático y bases de datos con un clic, corriendo en hardware que ya tienes. Así se pone a funcionar en Proxmox y esto es lo que puedes esperar en el uso diario.
Por qué Coolify y por qué ahora
El espacio de PaaS autoalojados tiene algunos competidores (CapRover, Dokku, Dokploy), pero Coolify se adelantó en pulido y velocidad de desarrollo. A mayo de 2026 supera las 55.000 estrellas en GitHub, y el ritmo de versiones de la v4 ha sido intenso.
Lo que realmente importa para un ingeniero con homelab:
- Instalación sencilla, sin depender de Kubernetes. Coolify corre como un conjunto de contenedores Docker administrados por un proceso supervisor. Tu contenedor LXC de Proxmox se mantiene liviano.
- Más de 280 servicios con un clic: bases de datos (Postgres, MySQL, Redis, MongoDB), stacks de monitoreo (Grafana + Prometheus), MinIO, Uptime Kuma, n8n. Si ya corres estas cosas a mano, solo esto justifica evaluarlo.
- Builds con Railpack: una alternativa más nueva a Buildpacks/Nixpacks que maneja apps de Node, Python, Go, PHP y .NET con mejor caché y builds en frío más rápidos.
- Servidor MCP:
coolify-mcppermite que Claude Code y otros clientes MCP hablen directamente con tu instancia de Coolify para desplegar, revisar el estado y administrar servicios. Es realmente útil si usas Claude en tu flujo de desarrollo. - Ollama como servicio de primera clase: un clic para levantar una instancia de Ollama, con passthrough de GPU configurable si tu host LXC expone una GPU.
Lo que todavía le falta a Coolify frente a Render o Railway es el autoescalado y el trazado distribuido integrado. Para un homelab o un equipo pequeño con tráfico predecible, no es un impedimento.
Hardware y requisitos previos
Cualquier máquina con Proxmox VE 8 o más nuevo sirve. Un Beelink GTi13 Ultra con i9-13900HK, por ejemplo, tiene potencia de sobra para un LXC dedicado a Coolify junto a otros servicios.
Especificaciones mínimas para el LXC:
- 2 vCPU (4 o más recomendados si vas a correr varias apps)
- 4 GB de RAM (8 GB si vas a desplegar bases de datos dentro de Coolify)
- 40 GB de disco (en SSD: los despliegues escriben mucho durante los builds)
Si empiezas de cero y buscas una máquina para tu homelab, el Minisforum MS-01 es hoy el rey en relación calidad-precio para esta carga: doble 2.5GbE, NVMe PCIe 5.0 y maneja Proxmox + varios contenedores LXC sin esfuerzo. El CWWK N100 es una opción más barata si solo quieres un nodo dedicado a Coolify y nada más.
Para el almacenamiento dentro del LXC, usa un NVMe rápido. El Samsung 990 Pro de 2 TB es excelente, pero incluso el WD SN770 de 1 TB es lo bastante rápido para las cachés de build.
Crea el contenedor LXC en Proxmox
Hay un script de la comunidad para Proxmox que crea el LXC y hace la instalación inicial de una sola vez. Desde la consola de Proxmox:
bash -c "$(wget -qLO - https://github.com/community-scripts/ProxmoxVE/raw/main/ct/coolify.sh)"El script te pide el ID del contenedor, el hostname, el tamaño de disco, la CPU y la RAM; luego descarga una plantilla Debian 12 y corre el instalador de Coolify dentro. Tiempo total: unos 5 minutos con una conexión decente.
Si prefieres hacerlo a mano (lo recomiendo si quieres controlar la configuración de red y almacenamiento):
# Create LXC from Proxmox shell
pct create 200 local:vztmpl/debian-12-standard_12.7-1_amd64.tar.zst \
--hostname coolify \
--cores 4 \
--memory 8192 \
--swap 2048 \
--rootfs local-lvm:40 \
--net0 name=eth0,bridge=vmbr0,ip=dhcp \
--unprivileged 1 \
--features nesting=1
pct start 200
pct enter 200Dentro del contenedor, el flag nesting=1 es obligatorio: Coolify usa Docker, y Docker dentro de LXC necesita nesting activado o no arranca. Sin él vas a ver errores de cgroup poco claros y difíciles de depurar.
# Inside the LXC
apt update && apt install -y curl ca-certificates
# Run the official Coolify installer
curl -fsSL https://cdn.coollabs.io/coolify/install.sh | bashEl instalador descarga Docker, crea los archivos de servicio de Coolify y arranca todo. Fíjate en la salida final: imprime la URL de tu instancia y las credenciales iniciales de administrador.
Configuración inicial
Cuando termina el instalador, Coolify está disponible en http://[container-ip]:8000. El primer arranque tarda unos 30 segundos mientras los contenedores se descargan e inician.
El asistente de configuración es sencillo:
- Crea tu cuenta de administrador
- Configura la URL de la instancia (pon el dominio público o la dirección de Tailscale que vas a usar: Coolify la usa para Let's Encrypt y para los callbacks de webhooks)
- Elige el tipo de servidor: localhost para apps que corren en la misma máquina que Coolify, o remote para conectarse por SSH a otro destino de despliegue
En un homelab, localhost tiene sentido al principio. Si tienes un servidor de aplicaciones aparte o un VPS donde despliegas, agrégalo como servidor remoto y pega tu llave SSH. Coolify hace el resto.
Dominio propio con Cloudflare Tunnel
Una buena forma de exponer Coolify y las apps que despliega es con Cloudflare Tunnel en lugar de abrir puertos. El flujo:
- Cloudflare Tunnel →
coolify.yourdomain.com→ IP del contenedor, puerto 8000 (el panel de Coolify) - Coolify administra su propia instancia de Traefik para enrutar las apps desplegadas
- Cada app recibe un subdominio que pasa por el mismo túnel
En la configuración de Coolify, deja Traefik como proxy (por defecto) y configura tu dominio wildcard. Coolify obtendrá automáticamente certificados de Let's Encrypt para cada app que despliegues.
Despliega tu primera app
El modelo de proyectos de Coolify es: Proyecto → Entorno → Servicio/Aplicación. Crea un proyecto, agrega un entorno (producción, staging, etc.) y luego agrega un recurso.
Para una app desde Git:
Resources → Add New Resource → Application
→ Select: GitHub (or Gitea/Forgejo if self-hosted)
→ Paste repo URL
→ Select build pack: Nixpacks, Railpack, or Dockerfile
→ Configure environment variables
→ Set domain
→ DeployRailpack es la opción más nueva y vale la pena probarla primero con apps de Node/Python/Go: genera imágenes más pequeñas y cachea las capas de forma más agresiva, así que los builds siguientes al primero suelen ser bastante más rápidos que con Nixpacks.
Para un despliegue con Dockerfile puro, Coolify respeta tu Dockerfile existente sin modificarlo. Si ya tienes contenedores corriendo en local, migrar es básicamente conectar las variables de entorno y apuntar a tu registro.
Servicios de un clic que vale la pena correr
El catálogo de servicios es donde Coolify se gana su lugar. Algunos útiles de inmediato:
Postgres + pgAdmin: un clic, con respaldos automáticos a almacenamiento compatible con S3 (apúntalo a tu instancia local de MinIO si tienes una). El programador de respaldos viene integrado, algo que de otro modo armarías a mano con cron y pg_dump.
Uptime Kuma: si todavía no lo usas, es el monitor de estado más limpio del ecosistema de self-hosting. Se configura en dos minutos desde Coolify.
n8n: si ya corres n8n a mano en otro LXC, Coolify puede administrar su ciclo de vida. No vale la pena migrarlo a mitad de un flujo de trabajo, pero para empezar de cero es más fácil aquí que con Docker Compose a mano.
Ollama: levanta una instancia de Ollama con passthrough de GPU si tu host LXC expone una. Para el passthrough de GPU a LXC en Proxmox, tienes que configurar el contenedor con los nodos de dispositivo correspondientes:
# In /etc/pve/lxc/200.conf, add:
lxc.cgroup2.devices.allow: c 195:* rwm
lxc.cgroup2.devices.allow: c 511:* rwm
lxc.mount.entry: /dev/nvidia0 dev/nvidia0 none bind,optional,create=file
lxc.mount.entry: /dev/nvidiactl dev/nvidiactl none bind,optional,create=file
lxc.mount.entry: /dev/nvidia-uvm dev/nvidia-uvm none bind,optional,create=fileLa NVIDIA RTX 4060 Ti o la AMD Radeon RX 7600 son GPUs populares en homelabs que manejan bien Ollama sin el consumo de las tarjetas de gama alta.
La integración con el servidor MCP
Coolify v4.1 trae un servidor MCP integrado, y es la función más interesante de esta versión. Desde una sesión de Claude Code (o cualquier cliente compatible con MCP), puedes:
# Add to your claude_desktop_config.json or .claude/settings.json
{
"mcpServers": {
"coolify": {
"command": "npx",
"args": ["coolify-mcp"],
"env": {
"COOLIFY_BASE_URL": "https://coolify.yourdomain.com",
"COOLIFY_API_TOKEN": "your-api-token"
}
}
}
}A partir de ahí, Claude Code puede listar tus servicios, lanzar despliegues, leer logs y revisar el estado de los recursos, todo sin salir de tu entorno de programación. La integración todavía es joven, pero las piezas básicas son sólidas.
Genera tu token de API en Coolify → Security → API Tokens. El token tiene los mismos permisos que tu usuario, así que crea una cuenta de servicio dedicada si compartes la instancia de Coolify.
Detalles y verdades incómodas
Acceso al socket de Docker en LXC sin privilegios: el flag nesting=1 resuelve casi todo, pero a veces las operaciones de Docker fallan con errores de permisos después de reiniciar el host de Proxmox. Si ves permission denied en llamadas al socket de Docker, reinicia el LXC completo en lugar de solo el servicio; normalmente se soluciona.
Uso de disco por los builds: Coolify no limpia de forma agresiva las imágenes de builds viejos. Después de unas semanas de despliegues activos puedes acumular varios GB de capas obsoletas. Agrega un cron dentro del LXC:
# /etc/cron.weekly/docker-prune
#!/bin/bash
docker image prune -f --filter "until=168h"
docker builder prune -f --filter "until=168h"Coolify se actualiza solo: por defecto busca actualizaciones y las aplica automáticamente. Normalmente está bien, pero si quieres fijar una versión específica por estabilidad, desactiva las actualizaciones automáticas en Settings → General y actualiza a mano.
Conflictos con Traefik: si ya corres Traefik o Nginx Proxy Manager en la misma máquina, vas a tener conflictos con los puertos 80/443. O corres Coolify en un LXC dedicado con su propia IP, o configuras Coolify para usar un rango de puertos personalizado y pones tu proxy existente delante.
No hay webhook nativo de Gitea/Forgejo en LAN: si autoalojas tu Git (por ejemplo, en Forgejo), el webhook de Coolify tiene que poder llegar a tu servidor de Git. En un setup solo de red local con direcciones privadas, quizás tengas que configurar la URL del webhook a mano y asegurarte de que el DNS resuelva entre contenedores.
¿Vale la pena cambiarse?
Para un homelab: sí, sin mucha duda. El esfuerzo de administrar stacks de Docker Compose sueltos en varios proyectos se acumula, y Coolify maneja el ciclo de vida de forma limpia. Solo el catálogo de servicios de un clic te ahorra horas frente a mantener tus propios archivos compose.
Para reemplazar un PaaS en la nube con cargas reales: depende de tus patrones de tráfico y de la disponibilidad que necesites. Coolify no resuelve las fallas de hardware: tus apps se caen cuando se cae tu servidor. Si necesitas failover en varias regiones o una disponibilidad respaldada por un SLA, todavía necesitas un proveedor de nube o un setup más complejo. ¿Para herramientas internas, entornos de staging y proyectos personales? Es excelente.
La combinación de Railpack + MCP hace que la v4.1 en particular valga la actualización desde cualquier versión vieja de Coolify. Si lo probaste en 2024 y te frenaron las asperezas, dale otra oportunidad: la versión de 2026 es un producto bastante distinto.
Hardware mencionado en este artículo:
- Beelink GTi13 Ultra (i9-13900HK)
- Minisforum MS-01
- Mini PC CWWK N100
- NVMe Samsung 990 Pro de 2 TB
- NVMe WD SN770 de 1 TB
- NVIDIA RTX 4060 Ti
- AMD Radeon RX 7600
Aviso: este artículo contiene enlaces de afiliado. Si compras a través de ellos, puedo ganar una pequeña comisión sin costo extra para ti.
¿Quieres algo así para tu negocio?
Instalo infraestructura privada y autoalojada en Proxmox: IA, automatización y herramientas internas en hardware que es tuyo, documentado y entregado. Ver el stack de IA privada →
¿No sabes qué necesitas? Agenda una llamada gratis.