Skip to content

An open-source, self-hostable PaaS alternative to Vercel, Heroku & Netlify that lets you easily deploy static sites, databases, full-stack applications and 360+ one-click services on your own servers.

1.2 KB
Raw Blame

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.