Skip to content

[FEATURE] Guía oficial de deploy con Coolify #2

@RGJorge

Description

@RGJorge

Problem you're trying to solve

Coolify es una de las plataformas self-hosted más usadas para deploy de aplicaciones Docker, pero ContainerFlow no tiene guía oficial para usuarios que quieran desplegarlo con esa herramienta.

Hoy un usuario externo (Brian) lo implementó en producción con Coolify en pocos pasos y publicó al respecto en LinkedIn, pero la integración no está documentada en el repo. Cualquier nuevo usuario de Coolify
tiene que descubrir por su cuenta cómo configurarlo, qué env vars setear, cómo montar el socket de Docker, etc.

Proposed solution

Crear docs/deploy-coolify.md con guía paso a paso. Incluir:

  • Pasos exactos en la UI de Coolify ("Deploy from public repository" / Dockerfile / Compose, según lo que haya usado Brian)
  • Env vars requeridas y sus valores recomendados: DATA_DIR, AUTH_TOKEN, ALLOWED_PATHS, HOST_PROJECTS_DIR
  • Configuración de volúmenes para /var/run/docker.sock y data/
  • Cualquier quirk específico de Coolify (build args, port exposure, healthcheck)
  • Tiempo objetivo: deploy en ≤ 10 minutos para un usuario nuevo de Coolify

Adicionalmente:

  • Agregar sección "Deploy con Coolify" en el README junto al flujo actual de docker compose up -d
  • Linkear desde docs/docker-guide.md

Why existing features don't cover this

El README actual sólo documenta el flujo git clone + docker compose up. Un usuario de Coolify tiene que traducir mentalmente ese flujo a la UI de Coolify, lo cual:

  • Requiere saber qué env vars son obligatorias y cuáles opcionales
  • Requiere entender cómo montar el socket de Docker en Coolify (no es trivial)
  • Requiere asumir defaults que pueden no funcionar fuera de un docker compose directo

Mockup / example

Referencia: post de Brian en LinkedIn donde implementó ContainerFlow con Coolify en producción y compartió la experiencia:

https://www.linkedin.com/posts/brianx2001_en-una-frase-portainer-te-da-control-grafana-share-7459634221435981824-9y5b

Su descripción del caso de uso:

"Portainer te da control, Grafana te da métricas, Dozzle te da logs. ContainerFlow te da comprensión visual de tu arquitectura con todo lo anterior integrado y liviano."

Alternatives considered

  • Dejar que cada usuario descubra el setup por su cuenta — funciona, pero genera issues recurrentes y fricción de adopción innecesaria.
  • Crear un Coolify template/preset oficial — opción ideal a largo plazo si Coolify soporta templates publicables, pero requiere investigar la API/spec de Coolify primero. La guía Markdown es el paso
    intermedio razonable.

Priority / urgency for you

  • Critical — blocking my workflow
  • High — would significantly improve my workflow
  • Medium — nice to have
  • Low — just an idea

Razón: Coolify es uno de los stacks self-hosted más adoptados — documentar la integración amplía el público objetivo del proyecto de forma significativa, y ya hay un caso de uso real validado.

Are you willing to wait?

  • Yes, I'll wait — I just want to flag this
  • I'd contribute a PR if/when PRs open
  • I need this fast — happy to discuss sponsorship/commercial support

Lo voy a tomar yo mismo. Necesito coordinar con Brian para que la guía refleje un setup real, no teórico.

Metadata

Metadata

Assignees

Labels

documentationImprovements or additions to documentationenhancementNew feature or request

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions