mirror of
https://github.com/tiennm99/coolify.git
synced 2026-08-24 00:27:47 +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.
36 lines
1.2 KiB
Markdown
36 lines
1.2 KiB
Markdown
# 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:
|
|
|
|
```text
|
|
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](overview.md) | High-level mental model and data flow. |
|
|
| [Responsibility split](responsibility-split.md) | What belongs in Coolify, Flux, and coold. |
|
|
| [Primitives](primitives.md) | Canonical host primitive surface Coolify may dispatch. |
|
|
| [Deploy flows](deploy-flows.md) | User-functionality flows, starting with `nginx:alpine`. |
|
|
| [ADRs](adr/README.md) | Architecture decision records for Coolify, Flux, coold, and their contracts. |
|
|
| [ADR 0001](adr/0001-control-plane-flux-coold-split.md) | 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.
|