Coolify self-hosted en tu propio servidor

Introducción

Coolify es una alternativa open source y self-hosted a plataformas como Vercel, Netlify o Heroku. Lo apuntás a un servidor, instala Docker y un reverse proxy por vos, y a partir de ahí tenés un panel para desplegar apps, bases de datos y servicios con certificados SSL sin configurar nada extra.

Corre en prácticamente cualquier servidor Linux: Debian, Ubuntu, Fedora, Arch, incluso una Raspberry Pi. Si lo que tenés es una máquina con Windows o macOS también podés levantarlo para probarlo, con WSL 2 en Windows y Docker Desktop en macOS, pero para un despliegue real vas a querer una máquina Linux con IP pública.

En este artículo te muestro cómo instalarlo en tu propio servidor, servirlo desde tu propio dominio y desplegar una primera app. Voy a usar un servidor Debian recién creado como ejemplo, pero los pasos son los mismos en cualquier distribución de Linux; solo cambian los comandos del gestor de paquetes. Este mismo blog está desplegado con Coolify.

Para esta guía asumo que ya tenés un VPS con una distribución de Linux soportada, acceso SSH como root y un dominio cuyos registros DNS podés editar.

Qué necesitás

• Un servidor con una distribución de Linux soportada (Debian, Ubuntu, Fedora, RHEL, Arch, Alpine o Raspberry Pi OS), con al menos 2 núcleos de CPU, 2 GB de RAM y 30 GB de disco. Es el mínimo de Coolify; vas a querer más si pensás correr bases de datos junto a tus apps.
• Acceso root por SSH.
• Un dominio, o un subdominio, apuntando al servidor.

Preparando el servidor

Conectate al servidor y actualizá el sistema. Las imágenes mínimas muchas veces no traen curl, que el instalador necesita, así que instalalo también. En Debian (y Ubuntu) se ve así:

ssh root@IP_DE_TU_SERVIDOR

apt update && apt upgrade -y
apt install -y curl

Abriendo el firewall

Debian no activa un firewall por defecto, y muchas imágenes de VPS tampoco. Si querés uno (y deberías), abrí SSH, HTTP, HTTPS y los tres puertos que Coolify usa para el panel, los websockets y la terminal. En Debian y Ubuntu lo más simple es ufw:

apt install -y ufw
ufw allow 22/tcp
ufw allow 80/tcp
ufw allow 443/tcp
ufw allow 8000/tcp
ufw allow 6001/tcp
ufw allow 6002/tcp
ufw enable

Instalando Coolify

Toda la instalación es un único script:

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

Tarda unos minutos. En el camino instala Docker si no está, crea /data/coolify para su configuración y volúmenes, genera una clave SSH y la agrega al authorized_keys de root, y por último levanta los contenedores de Coolify. Cuando termina, imprime la URL de tu nuevo panel.

Creando la cuenta de administrador

Abrí http://IP_DE_TU_SERVIDOR:8000 en el navegador. La primera cuenta que registrás pasa a ser la de administrador y el registro se cierra automáticamente después, así que hacelo apenas termine el instalador.

Una vez adentro, el asistente inicial te pregunta dónde querés desplegar. Elegí localhost, que es el servidor donde corre el propio Coolify. Te crea un proyecto con un entorno de producción; podés saltear la creación de un recurso por ahora, llegamos a eso en un momento.

Apuntando un dominio a tu instancia

Por ahora el panel se sirve por HTTP plano en el puerto 8000. Vamos a ponerlo detrás de un dominio propio con HTTPS. Empezá creando dos registros DNS en tu registrador: uno para el panel y un wildcard para las apps que vas a desplegar después.

coolify.tudominio.com    A    IP_DE_TU_SERVIDOR
*.apps.tudominio.com     A    IP_DE_TU_SERVIDOR

Después, en Coolify, andá a Settings y configurá Instance's Domain con https://coolify.tudominio.com. Guardá, esperá unos segundos y abrí esa URL: el proxy integrado (Traefik) pide un certificado de Let's Encrypt y el panel ya queda en HTTPS.

Ahora andá a Servers -> localhost y configurá Wildcard Domain con https://apps.tudominio.com. Cada recurso nuevo que crees va a recibir un subdominio ahí automáticamente, así no tenés que tocar el DNS por cada app.

Como el panel ya tiene dominio, los tres puertos de la instalación se pueden cerrar:

ufw delete allow 8000/tcp
ufw delete allow 6001/tcp
ufw delete allow 6002/tcp

Desplegando tu primera app

Andá a Projects, abrí el proyecto que creó el asistente, elegí el entorno Production y hacé clic en + New. Vas a ver una lista larga de recursos: aplicaciones, bases de datos y servicios de un clic. Para una app, elegí Public Repository y pegá la URL de un repo de Git.

• Elegí la rama a desplegar.
• Elegí un build pack. Nixpacks resuelve la mayoría de los proyectos solo; si el repo tiene un Dockerfile, elegí Dockerfile.
• Configurá el puerto en el que escucha tu app (3000 para una app típica de Next.js).
• Configurá el dominio, por ejemplo https://blog.apps.tudominio.com, o dejá el que se generó.

Apretá Deploy y seguí los logs. El primer build tarda un rato porque tiene que descargar todo; cuando termina, abrí el dominio y deberías ver tu app por HTTPS.

Para repositorios privados y despliegues automáticos con cada push, andá a Sources y conectá una GitHub App en vez de usar una URL pública. Coolify te guía para crearla en tu cuenta de GitHub y, a partir de ahí, los recursos nuevos pueden elegir cualquiera de tus repos.

Manteniéndolo sano

Algunas opciones que vale la pena activar desde el principio:

• Actualizaciones automáticas: en Settings podés dejar que Coolify se actualice solo. Si preferís hacerlo a mano, volver a correr el script de instalación actualiza una instancia existente.
• Backups: también en Settings, programá un backup de la base de datos del propio Coolify hacia un bucket compatible con S3. Perderla significa reconfigurar todos los recursos.
• Notificaciones: conectá Telegram, Discord o email para enterarte de los despliegues fallidos antes que tus usuarios.

¡Eso es todo! Ya tenés tu propio mini PaaS corriendo en un solo servidor. Desde acá podés sumar más servidores al mismo panel, levantar bases de datos con un clic o configurar preview deployments para los pull requests.