mirror of
https://github.com/tiennm99/coolify.git
synced 2026-08-20 04:23:34 +00:00
Andras Bacsai
4938b65f20
Remove active builder flags from dev Lima sync, bootstrap commands, and server capabilities while documenting the v5 control-plane and host-agent boundaries.
1.2 KiB
1.2 KiB
Coolify v5 Architecture
This directory is the canonical architecture reference for Coolify v5 from the Laravel control-plane point of view.
v5 has three major building blocks:
User / API / Git webhook
↓
Coolify Laravel control plane
↓ HTTP over /run/coolify/flux.sock
Flux
↓ outbound gRPC Agent.Stream
coold on each host
↓
Podman / networks / firewall / DNS / Corrosion / builder
Documents
| Document | Purpose |
|---|---|
| Overview | High-level mental model and data flow. |
| Responsibility split | What belongs in Coolify, Flux, and coold. |
| Primitives | Canonical host primitive surface Coolify may dispatch. |
| Deploy flows | User-functionality flows, starting with nginx:alpine. |
| ADRs | Architecture decision records for Coolify, Flux, coold, and their contracts. |
| ADR 0001 | Decision record for the v5 split. |
Core rule
Coolify owns user intent and application state. Flux routes requests. coold executes explicit host primitives. coold must not grow app, team, RBAC, deployment, billing, or audit concepts.