Aplica a: Cloud Server · Tiempo estimado: 15 min
¿Qué vas a lograr?
Instalar Coolify en tu Cloud Server, configurar el dominio con SSL y dejarlo listo para desplegar aplicaciones, bases de datos y servicios sobre infraestructura propia.
Qué es Coolify
Coolify es una plataforma de código abierto y autoalojada que permite desplegar y administrar aplicaciones de forma similar a Heroku, Vercel o Netlify, pero con control total sobre los datos y la infraestructura.
1. Instalación
Opción A — Imagen Click&Go (recomendada)
En Mi cuenta, andá a Mis Servicios → Cloud & IaaS, seleccioná el servidor, hacé clic en Gestionar
Andá a Software y accesos, buscá la imagen Coolify en el catálogo y presioná Siguiente
Elegí el método de autenticación y hacé clic en Siguiente
Revisá la información y hacé clic en Confirmar e instalar
La imagen instala automáticamente la última versión estable junto con Docker y todos los componentes necesarios:
Componente | Descripción |
🐳 Coolify Core | Contenedor principal con la interfaz web y el motor de orquestación de Coolify. |
🗄️ PostgreSQL | Base de datos interna donde Coolify almacena la configuración, proyectos, recursos y usuarios. |
⚡ Redis | Motor de caché y cola de tareas utilizado para operaciones en segundo plano. |
🌐 Proxy integrado | Reverse proxy para acceder a Coolify y a las aplicaciones desplegadas mediante un dominio propio con soporte SSL. |
📁 Volúmenes persistentes | Los datos de configuración, proyectos y recursos se almacenan en volúmenes Docker que persisten ante reinicios. |
Los archivos de configuración quedan en /root/app del servidor:
docker-compose.yml— orquesta los contenedores.env— variables de configuraciónapp-nginx.conf— configuración de Nginx
Cualquier modificación en .env o docker-compose.yml requiere ejecutar:
docker compose up -d
Opción B — Instalación manual
Iniciá con una imagen Ubuntu mínima, instalá Docker y seguí la documentación oficial de Coolify. Esta opción está recomendada solo para usuarios con experiencia en administración de servidores Linux.
2. Configurar el dominio y el certificado SSL
La imagen Click&Go incluye una herramienta integrada para configurar el dominio y SSL automáticamente:
En Mi cuenta, andá a tu Cloud Server → Software y accesos → Coolify → Configurar Dominio y SSL
Ingresá el dominio o subdominio (por ejemplo deploy.tudominio.com) y verificá que apunte a la IP del servidor
En unos minutos la herramienta confirma la configuración y podés acceder a Coolify por HTTPS
Esta funcionalidad solo está disponible para instalaciones Click&Go. En instalaciones manuales, la configuración de dominio y SSL debe hacerse por cuenta propia.
3. Crear el usuario administrador
Este paso es crítico — hacélo inmediatamente después de configurar el dominio. El formulario de registro es público: cualquier persona que conozca el dominio puede crear la cuenta administradora y tomar control de la instancia.
Ingresá al dominio o subdominio configurado desde el navegador
Completá el formulario de registro con nombre, email y contraseña segura (mínimo 8 caracteres)
Confirmá la creación de la cuenta
4. Primeros pasos dentro del panel
Una vez dentro, realizá estas configuraciones antes de desplegar recursos:
Servers — verificá que el Cloud Server aparezca en estado Reachable
Projects — creá un proyecto para agrupar aplicaciones, bases de datos y servicios relacionados
Sources — conectá proveedores de Git (GitHub, GitLab, Bitbucket o URL pública) para facilitar el despliegue
Destinations — revisá las redes Docker disponibles (Coolify incluye una por defecto)
+ New — desplegá aplicaciones desde repositorios Git, imágenes Docker, plantillas predefinidas (WordPress, bases de datos, etc.) o archivos
docker-compose
5. Configuración avanzada: variables de entorno
El archivo de configuración está en /root/app/.env. Antes de modificarlo, creá un backup:
cp /root/app/.env /root/app/.env.backup
Para configurar el envío de correos transaccionales (invitaciones, notificaciones, recuperación de contraseña), agregá los datos SMTP al .env:
# Configuración de emails
MAIL_DRIVER=smtp
MAIL_HOST=tu-servidor-smtp.com
MAIL_PORT=587
[email protected]
MAIL_PASSWORD=tu-contraseña-smtp
MAIL_ENCRYPTION=tls
[email protected]
MAIL_FROM_NAME="Coolify"
Después de editar el .env, recargá los contenedores:
cd /root/app && docker compose down && docker compose up -d
También podés configurar notificaciones por email, Discord, Telegram o Slack desde Notifications en la interfaz del panel.
Comandos útiles
# 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
Desde la interfaz, andá a Settings → Update y hacé clic en el botón de actualización.
También podés actualizarlo por SSH:
Ingresá por SSH al servidor
Ejecutá
cd /root/apppara ingresar al directorio de la aplicaciónRealizá un pull del contenedor actualizado y reinicialo:
docker compose pull
docker compose up -d
7. Consideraciones de seguridad
Completá el registro inmediatamente al activar el dominio
Usá una contraseña de al menos 12 caracteres con letras, números y símbolos
Activá el doble factor de autenticación (2FA) desde el perfil de usuario
Creá usuarios adicionales con permisos mínimos en lugar de compartir la cuenta administradora
Mantené abiertos solo los puertos necesarios en el firewall: 80, 443 y el puerto SSH