Primeros pasos con Coolify

Esta guía detalla los pasos necesarios para instalar, configurar y poner en marcha Coolify en un Cloud Server de Donweb. Coolify es una plataforma de código abierto, autoalojada, que permite desplegar y administrar aplicaciones, bases de datos y servicios de forma similar a Heroku, Vercel o Netlify, pero sobre infraestructura propia y con control total de los datos.

1. Instalación de Coolify

Opción 1: Imagen Click&Go (Recomendada)

Para una instalación rápida y sin complicaciones, se recomienda utilizar la imagen Click&Go de Coolify:

1. Acceder al Cloud Server sin software instalado.
2. Seleccionar la imagen de Coolify desde el catálogo de imágenes.
3. Presionar el botón Instalar y seguir las instrucciones en pantalla.

La imagen despliega los siguientes componentes:

Una vez instalada, los archivos de configuración se encuentran en /root/app del Cloud Server:

• docker-compose.yml — Orquesta el despliegue de los contenedores.
• .env — Define las variables de configuración de Coolify.
• app-nginx.conf — Configuración de Nginx.

docker compose up -d

Opción 2: Instalación manual

Para quienes prefieren tener control total sobre la instalación:

1. Iniciar con una imagen Ubuntu mínima en el Cloud Server.
2. Instalar Docker siguiendo esta guía de instalación de Docker.
3. Seguir las instrucciones detalladas en la documentación oficial de Coolify.
4. Configurar manualmente las dependencias, el reverse proxy y las variables de entorno.

2. Configuración de dominio y certificado SSL

La imagen Click&Go incluye una herramienta integrada para configurar automáticamente un dominio y certificado SSL, dejando la instancia lista para un entorno productivo y seguro.

1. Navegar a la configuración: desde MiCuenta, ingresar al Cloud Server, seleccionar Software y Accesos en el menú lateral → pestaña Coolify → botón Configurar Dominio y SSL.
2. Configurar el dominio: ingresar el dominio o subdominio deseado (por ejemplo, deploy.tudominio.com) y verificar que esté apuntando a la IP del servidor. Puede comprobarse mediante esta herramienta.
3. Esperar la configuración: en unos minutos, la herramienta confirmará la configuración y podrá accederse a Coolify por HTTPS mediante el dominio personalizado.

3. Primer acceso y creación del usuario administrador

1. Acceder a la instancia: ingresar desde el navegador al dominio o subdominio recién configurado.
2. Completar el formulario de registro inicial:
   • Nombre del usuario administrador
   • Email válido para notificaciones y recuperación
   • Contraseña segura (mínimo 8 caracteres)
3. Confirmar la creación de la cuenta de administrador.

¡Listo! La instancia queda preparada para comenzar a conectar servidores, crear proyectos y desplegar aplicaciones, bases de datos o servicios.

4. Primeros pasos dentro del panel

Una vez dentro del panel de Coolify, se recomienda realizar las siguientes configuraciones básicas antes de desplegar recursos:

• Servidor localhost: Coolify registra por defecto el propio Cloud Server como servidor de despliegue. Desde la sección Servers es posible verificar que se encuentre en estado Reachable.
• Proyectos: crear un proyecto desde la sección Projects. Los proyectos agrupan aplicaciones, bases de datos y servicios relacionados entre sí.
• Fuentes de código: conectar proveedores de Git (GitHub, GitLab, Bitbucket o un repositorio público vía URL) desde Sources para facilitar el despliegue de aplicaciones.
• Destinos: en Destinations se definen las redes Docker donde se desplegarán los recursos. Por defecto, Coolify incluye una red lista para usar.
• Nuevo recurso: desde + New es posible desplegar aplicaciones desde repositorios Git, imágenes Docker, plantillas predefinidas (WordPress, Plausible, Umami, bases de datos, etc.) o archivos docker-compose.

5. Configuración avanzada con variables de entorno

El archivo de configuración de Coolify se encuentra en /root/app/.env. Se recomienda acceder a este archivo únicamente cuando sea necesario realizar configuraciones avanzadas. Para la mayoría de los casos, la configuración desde la interfaz web es suficiente.

cp /root/app/.env /root/app/.env.backup

Configuración de SMTP (correo electrónico)

Coolify envía correos transaccionales en distintas situaciones: invitación de usuarios al equipo, notificaciones de despliegue, alertas de estado de recursos y recuperación de contraseña, entre otros. Para habilitar el envío confiable de estos correos, se recomienda configurar un servidor SMTP en el archivo .env. Puede utilizarse cualquier servicio SMTP, como EnvíaloSimple.

# Configuración de emails
MAIL_DRIVER=smtp
MAIL_HOST=tu-servidor-smtp.com
MAIL_PORT=587
MAIL_USERNAME=tu-email@tudominio.com
MAIL_PASSWORD=tu-contraseña-smtp
MAIL_ENCRYPTION=tls
MAIL_FROM_ADDRESS=no-reply@tudominio.com
MAIL_FROM_NAME="Coolify"

cd /root/app && docker compose down && docker compose up -d

Adicionalmente, desde la propia interfaz de Coolify, en Notifications, pueden configurarse notificaciones por email, Discord, Telegram o Slack para eventos relevantes de la plataforma.

Comandos útiles para administración

# Cambiar al directorio de la aplicación
cd /root/app

# Ver estado de los contenedores
docker compose ps

# Ver logs en tiempo real
docker compose logs -f

# Reiniciar todos los servicios
docker compose restart

# Detener servicios
docker compose down

# Iniciar servicios
docker compose up -d

# Acceder al contenedor principal de Coolify
docker compose exec coolify bash

# Ver uso de espacio de Docker
docker system df

# Limpiar contenedores, imágenes y redes no utilizadas
docker system prune

6. Actualizar Coolify

Coolify incluye un botón de actualización integrado en la propia interfaz, dentro de la sección Settings > Update, que permite actualizar la plataforma a la última versión estable con un solo clic.

Como alternativa, la actualización también puede realizarse de forma manual por línea de comandos:

1. Ingresar por SSH al servidor.
2. Ejecutar cd /root/app para ingresar al directorio de la aplicación.

3. Realizar un pull del contenedor actualizado y reiniciarlo: 

   docker compose pull
   docker compose up -d

4. ¡Listo! La instancia de Coolify se encuentra actualizada. La versión puede verificarse desde la interfaz web.

7. Consideraciones de seguridad

Se recomienda aplicar las siguientes medidas básicas para mantener la instancia segura:

• Registro inmediato: completar el formulario de registro inicial en cuanto el dominio esté activo, para evitar que un tercero tome control de la instancia.
• Contraseña robusta: utilizar una contraseña de al menos 12 caracteres que combine letras, números y símbolos.
• Autenticación de dos factores (2FA): habilitar 2FA desde el perfil de usuario para reforzar el acceso al panel.
• Gestión de equipos y roles: crear usuarios adicionales con los permisos mínimos necesarios en lugar de compartir la cuenta administradora.
• Aislamiento Docker: la instalación Click&Go ejecuta Coolify dentro de contenedores Docker, lo que agrega una capa adicional de aislamiento.
• Firewall del Cloud Server: mantener abiertos únicamente los puertos necesarios (80 y 443 para HTTP/HTTPS, y 22 para SSH).
• Respaldos: verificar que las copias de seguridad del Cloud Server se encuentren activas y validar periódicamente su correcta ejecución.