Operations

Zero-downtime deployments

Switch traffic atomically with the Phelix reverse proxy.

Reverse proxy

The proxy daemon binds each app's public port and routes traffic to the active internal instance. Blue-green and rolling deploys switch the target atomically through a control socket — no dropped connections.

Routing model
Client → :8080 [phelix proxy] ── atomic target ──→ blue  :9001
                                                ↘ green :9002
Terminal
phelix proxy
phelix proxy status
phelix proxy stop
phelix proxy --foreground

phelix rebuild --blue-green and --replicas will auto-start the daemon if it is not already running.

Blue-green

Terminal
phelix rebuild myapp --blue-green --port 8080

Phelix builds on the inactive slot, waits for health, switches traffic, then drains the previous instance.

Rolling

Terminal
phelix rebuild myapp --replicas 3

Restarts N replicas one at a time — never more than one down — so capacity remains available during cutover.

Failure behavior

Deploy mode and proxy routing are visible in phelix list and phelix status:Deploy shows blue-green (blue|green) or rolling (×N) (or - for classic rebuilds), and Proxy shows on :<public> → <slot> when enrolled, otherwise off.