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	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.