Antes de comenzar
¿Coolify: qué es, cómo funciona y cuándo usarlo?
Para seguir esta guía necesitas:
Coolify instalado y funcionando correctamente.
¿Qué es un proyecto en Coolify?
En Coolify, un proyecto es un conjunto de aplicaciones, servicios y configuraciones administradas.
Puedes usar proyectos para organizar recursos relacionados, como:
Frontend
Backend
Bases de datos
Variables de entorno
Dominios
Servicios adicionales
Configuraciones de red
Por ejemplo, puedes crear un proyecto para agrupar todos los servicios de una aplicación web.
1. Crear un nuevo proyecto en Coolify
Accede al dashboard de Coolify desde tu navegador.
En el menú principal, ve a la sección Projects y haz clic en Add.
Completar los datos del proyecto
En el formulario de creación, completa los campos solicitados.
En Name, escribe un nombre para el proyecto. Por ejemplo:
Proyecto V2Networks
En Description, puedes agregar una descripción breve. Por ejemplo:
Proyecto de ejemplo para desplegar aplicaciones con Coolify en V2Networks
Luego haz clic en Continue.
Confirmar la creación del proyecto
Si el proyecto se crea correctamente, Coolify mostrará la página de entornos del proyecto.
Normalmente verás un entorno inicial llamado:
production
Desde esta página podrás crear aplicaciones, bases de datos y servicios asociados al proyecto.
2. Desplegar una aplicación de ejemplo
En esta sección desplegarás una aplicación estática dentro del proyecto creado anteriormente.
Para este ejemplo usaremos un repositorio público de GitHub proporcionado por Coolify.
Acceder al proyecto
En el menú lateral de Coolify, haz clic en Projects.
Selecciona el proyecto que creaste anteriormente, por ejemplo:
Proyecto V2Networks
Dentro del proyecto, haz clic en Add New Resource para crear un nuevo recurso.
3. Seleccionar el tipo de recurso
En la pantalla de creación de recurso, busca la sección Git Based.
Selecciona la opción Public Repository.
Esta opción permite desplegar una aplicación desde un repositorio público de GitHub sin conectar una cuenta privada ni configurar OAuth.
4. Configurar el repositorio público
En el campo de URL del repositorio, ingresa la siguiente dirección:
https://github.com/coollabsio/coolify-examples.git
Este repositorio contiene aplicaciones de ejemplo que pueden usarse para probar despliegues en Coolify.
Haz clic en Check repository.
Coolify revisará el repositorio y validará que pueda acceder al código fuente.
5. Configurar el tipo de aplicación
En el campo Build Pack, selecciona:
Static
La opción Static se usa para aplicaciones que sirven archivos estáticos, como HTML, CSS y JavaScript.
En el campo Base Directory, reemplaza el valor predeterminado por:
/static
Esto indica a Coolify que debe usar únicamente los archivos ubicados dentro del directorio /static del repositorio. Quedando de la siguiente manera:
6. Revisar la configuración del recurso
Antes de desplegar la aplicación, revisa las opciones disponibles en la configuración del recurso.
Puedes revisar secciones como:
General
Build
Advanced
Environment Variables
Servers
Webhooks
Metrics
Networks
Healthcheck
Para este ejemplo, puedes mantener la mayoría de los valores predeterminados, salvo las configuraciones indicadas en los siguientes pasos.
7. Configurar redes y puertos
Desplázate hacia abajo, hasta la sección Networks.
En el campo Port Mappings, ingresa:
80:80
Esta configuración asigna el puerto 80 del contenedor al puerto 80 del servidor. Esto permite que la aplicación sea accesible públicamente mediante HTTP.
Importante sobre el puerto 80
Usa 80:80 solo si no tienes otro servicio usando el puerto 80 directamente en el servidor.
Si Coolify está gestionando el acceso mediante proxy inverso y dominios, normalmente es mejor dejar que Coolify enrute el tráfico hacia el contenedor para evitar conflictos de puertos.
8. Activar Healthcheck
Ve a la sección Healthcheck.
Marca la casilla Enabled para activar la verificación de salud de la aplicación, Confirma la advertencia.
El healthcheck permite que Coolify valide si el contenedor responde correctamente después del despliegue.
Luego haz clic en Save para guardar los cambios.
9. Desplegar la aplicación
Regresa a la sección General.
Haz clic en Deploy.
Coolify iniciará el proceso de despliegue de la aplicación.
Ver los logs del despliegue
Después de hacer clic en Deploy, Coolify abrirá la pantalla Deployment Log, donde podrás ver los logs en tiempo real.
Durante el despliegue, Coolify realizará tareas como:
Clonar el repositorio público de GitHub.
Leer la configuración del proyecto.
Preparar la aplicación estática.
Construir el contenedor.
Iniciar el servicio.
Configurar el acceso público.
Ejecutar el healthcheck.
Verificar el estado del despliegue.
Cuando el despliegue finalice correctamente, el estado cambiará a:
Finished
Esto indica que la aplicación fue construida y desplegada correctamente.
10. Obtener la URL de la aplicación
En la página de la aplicación, haz clic en Links.
Copia la URL generada por Coolify.
La URL puede ser un dominio temporal generado por Coolify o un dominio personalizado, si ya lo configuraste previamente.
11. Abrir la aplicación en el navegador
Abre una nueva pestaña en tu navegador.
Pega la URL copiada desde Coolify y presiona Enter.
Si el despliegue fue exitoso, deberías ver el sitio web estático cargando correctamente.
12. Acceder usando la IP del servidor
También puedes probar el sitio usando la IP pública de tu servidor de V2Networks.
Abre una nueva pestaña en el navegador e ingresa:
http://<server-ip>
Reemplaza <server-ip> por la IP pública de tu servidor.
Por ejemplo:
http://192.0.2.10
Si la configuración de puertos es correcta y no hay otro servicio usando el puerto 80, el sitio estático debería cargarse desde la IP del servidor.
Resultado final
Has creado un proyecto en Coolify y desplegado correctamente una aplicación estática desde un repositorio público de GitHub en tu servidor de V2Networks.
Con este procedimiento aprendiste a:
Crear un proyecto en Coolify.
Agregar un nuevo recurso.
Usar un repositorio público de GitHub.
Seleccionar el build pack Static.
Configurar el directorio base.
Configurar puertos.
Activar el healthcheck.
Ejecutar un despliegue.
Obtener la URL pública de la aplicación.
Verificar el sitio desde el navegador.
Este mismo flujo puede adaptarse para desplegar otros tipos de aplicaciones, como proyectos Node.js, Next.js, Laravel, Django, APIs backend o aplicaciones full-stack.
🤝 ¿Necesitas ayuda adicional?
En V2Networks, estamos comprometidos con la estabilidad y seguridad de tu sitio web. Si necesitas asistencia adicional, no dudes en contactarnos a través de nuestro Centro de Soporte














