Saltar a contenido

Qué es Coolify

Coolify es la plataforma con la que FADUA publica aplicaciones en el VPS. Sustituye a un PaaS tipo Heroku o Railway, pero corre en nuestro servidor: vos controlás el hardware, el DNS y los secretos.

Panel: https://coolify.fadua.ar

Qué hace y qué no hace

Coolify hace Coolify no hace
Clonar un repo, construir una imagen Docker y publicarla Escribir el código de la app
Dominio + HTTPS (Let's Encrypt) delante del contenedor Ser el login de GitHub.com
Variables de entorno, volúmenes, healthchecks Guardar contraseñas en el Markdown de este sitio
Auto-deploy cuando hay un push (si la GitHub App está bien) Cuentas de usuario con roles (el Basic Auth es una sola clave compartida)

GitHub guarda el código. Coolify solo lo despliega.

Piezas en el VPS

flowchart LR
  Internet -->|80 y 443| Traefik[coolify-proxy / Traefik]
  Traefik --> Docs[docs.fadua.ar]
  Traefik --> Panel[coolify.fadua.ar]
  Traefik --> Otras[otras apps]
  Docs --> Nginx[contenedor nginx]
  GitHub -->|webhook| Coolify[Coolify]
  Coolify -->|docker build| Nginx
  • VPS: el host. Docker lo instaló Coolify.
  • Coolify: orquesta deploys, redes y certificados.
  • Traefik (coolify-proxy): único proceso en los puertos 80 y 443. Todo lo público pasa por acá.
  • Recurso (Application): un contenedor (o un compose) publicado detrás de Traefik.

No hay que poner otro Nginx o Caddy en 80/443 del host: pelea con Traefik.

Palabras que aparecen en la UI

En Coolify Qué es
Project / Environment Carpeta lógica (production, etc.). No es un servidor aparte.
Source La GitHub App. Enlaza la org con Coolify. Se configura una vez.
Application Un servicio desplegado (este MkDocs, una API, etc.).
URL (Settings → Configuration) Dirección pública del panel. En esta instancia: https://coolify.fadua.ar. En versiones viejas se llamaba Instance FQDN.
HTTP Basic Authentication Usuario y contraseña del proxy, no de la app.

No confundir login de Coolify con GitHub App

Entrar al panel con usuario/contraseña de Coolify no conecta la organización de GitHub. Eso es una GitHub App instalada en FADUA-S-A.

Dominios de esta instancia

Qué URL
Panel Coolify https://coolify.fadua.ar
Esta documentación https://docs.fadua.ar
Org de GitHub FADUA-S-A
Repo de este sitio sla-crp-mkdocs

Cada app nueva necesita un registro A del subdominio hacia la IP del VPS, igual que coolify y docs.

Cómo se publica algo

  1. El código vive en un repo de FADUA-S-A (privado).
  2. Coolify tiene una GitHub App instalada en esa org, con acceso al repo.
  3. Se crea una Application apuntando a ese repo.
  4. Coolify construye (Dockerfile, Nixpacks, Railpack, etc.) y Traefik enruta el dominio.
  5. Un push a la rama configurada (main en este sitio) vuelve a desplegar, si Auto Deploy está activo.

Relacionado