Cómo instalar Coolify en un VPS

Requisitos previos

Tu VPS debe cumplir los requisitos mínimos oficiales: 2 vCPU, 2 GB de RAM, 30 GB de disco, Ubuntu 22.04 o 24.04, una dirección IPv4 pública, acceso root o sudo y SSH habilitado.

Antes de conectarte, crea un registro A como coolify.example.com apuntando a la IP del servidor. El DNS puede tardar en propagarse. También necesitas un cliente SSH y conocimientos básicos de paquetes, permisos y reglas de firewall.

No pongas credenciales reales en los comandos. Crearás la cuenta administradora desde el navegador, con una contraseña generada y guardada en un gestor de contraseñas.

Nota: Las versiones de Ubuntu que no son LTS (ej. 24.10, 25.04) no tienen soporte oficial y requieren pasos de instalación manual.

Paso 1, Conectarte a tu servidor

Conéctate con el usuario administrador que te haya dado el proveedor y actualiza el sistema:

ssh root@SERVER_IP
apt update && apt upgrade -y
apt install -y curl ca-certificates git

Sustituye SERVER_IP por la dirección real. Si tu proveedor usa un usuario sin privilegios, añade sudo a los comandos y entra en una shell de administrador solo cuando sea necesario.

Si el servidor será dedicado a esta instalación, puedes definir su hostname. Comprueba también que el reloj y el resolver DNS funcionan. No instales otro servidor web que ya esté usando los puertos 80 o 443, porque el proxy de Coolify necesita esos puertos para HTTP, HTTPS y la validación de certificados.

Paso 2, Instalar Docker y Docker Compose

Instala Docker Engine y el plugin de Compose siguiendo las instrucciones oficiales de Docker para tu versión de Ubuntu. Los paquetes suelen incluir docker-ce, docker-ce-cli, containerd.io, docker-buildx-plugin y docker-compose-plugin.

Comprueba la instalación y activa el servicio:

docker --version
docker compose version
systemctl enable --now docker

No copies el comando desde un blog sin verificar. La configuración del repositorio de Docker cambia con el tiempo, así que consulta siempre las instrucciones actuales. Ver las versiones confirma que el runtime existe, pero no que el servidor esté listo para producción.

Importante: Si instalas Docker por tu cuenta, usa el repositorio apt oficial de Docker. Docker instalado via Snap NO es compatible con Coolify y ROMPERÁ la instalación.

Paso 3, Ejecutar el instalador oficial

Coolify publica un instalador oficial de una sola línea que prepara sus contenedores Docker y su configuración:

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

El instalador crea los datos de la aplicación y arranca los servicios necesarios. Al terminar, revisa los contenedores y los logs recientes:

docker ps
docker compose ls
docker logs --tail 100 coolify

Los nombres exactos pueden cambiar según la versión. Si coolify no coincide con el nombre mostrado por docker ps, utiliza el nombre o proyecto que aparezca allí. No borres volúmenes durante el diagnóstico, porque contienen la configuración del panel y los metadatos de despliegue.

Advertencia: Inmediatamente después de la instalación, crea la cuenta de administrador desde la interfaz web en http://SERVER_IP:8000. Si alguien más se registra primero, podría tomar el control de tu instancia de Coolify.

Paso 4, Configurar el proxy inverso

Coolify incluye un proxy Traefik integrado que gestiona Let's Encrypt para las aplicaciones desplegadas. No necesitas configurar un proxy inverso por separado en el host. El host solo necesita los puertos 80 y 443 abiertos.

Permite el tráfico TCP entrante en los puertos 80 y 443, y restringe SSH a tus IPs de administración cuando el proveedor lo permita. Un firewall mínimo puede ser:

ufw allow OpenSSH
ufw allow 80/tcp
ufw allow 443/tcp
ufw enable
ufw status

Desde el panel, añade el servidor, selecciona el proxy de despliegue y configura el dominio. Apunta el DNS al VPS antes de pedir el certificado. Coolify puede solicitar y renovar certificados de Let's Encrypt cuando el dominio resuelve bien y el proxy puede alcanzar los puertos 80 y 443.

Paso 5, Primer acceso y configuración inicial

Abre la dirección de instalación en el navegador. Completa la creación del administrador, inicia sesión y cambia cualquier valor temporal. Añade un proyecto cuando el servidor esté en línea y el proxy indique que está saludable.

Para la primera prueba, despliega una aplicación pequeña y sin estado. Comprueba que resuelve por HTTPS, que el contenedor vuelve a arrancar tras un reinicio y que puedes ver sus logs en el panel. Decide cómo guardar los volúmenes antes de añadir una base de datos.

Mantenimiento

Lee las notas de la versión antes de actualizar Coolify. Haz backup del directorio de datos y de los volúmenes de las aplicaciones en un almacenamiento externo al VPS. Vigila el disco con df -h y el consumo de Docker con docker system df.

Si una actualización falla, guarda la salida de docker ps, docker compose ls y los logs del servicio afectado antes de tocar nada. No ejecutes limpiezas globales que borren volúmenes sin confirmar que ninguna aplicación los necesita.