Reference
Command reference
A compact map of the Phelix v1.0.0 command surface.
Every command below also supports interactive auto-prompting: run it without a required argument and Phelix asks for it (when stdin is a terminal). See Interactive wizard.
Application commands
| Command | Description |
|---|---|
| phelix build <NAME> | Compile, version, and start a Go or Rust project. |
| phelix rebuild <NAME> | Rebuild an existing app with classic or zero-downtime deployment. |
| phelix start [<NAME>] | Start one app, or every app when no name is supplied. --ensure builds if missing. |
| phelix stop <NAME> | Stop a running app. |
| phelix restart <NAME> | Restart an app. |
| phelix status <NAME> | Show PID, uptime, RAM/CPU, watching, version, deploy mode, and proxy routing. |
| phelix list | Table of every managed app with version, status, watching, deploy, and proxy columns. |
| phelix log [<NAME>] | Tail app logs (last 10 lines + live stream); no arg shows Phelix's own logs. |
| phelix remove <NAME> | Stop and remove an app from management. |
| phelix watch <NAME> | Enable (default) or disable backend monitoring for one app (--disable). |
Deployment & delivery
| Command | Description |
|---|---|
| phelix rebuild <NAME> | Rebuild an app; classic, zero-downtime (--blue-green / --replicas), or verified canary / progressive rollouts (--canary, --strategy) |
| phelix rollback <NAME> | Restore a previous version; --to targets a version or tag, --dry-run previews the plan, --reason and --verify record and observe it |
| phelix rollback history <NAME> | Recorded rollback outcomes for one app, newest first (--limit N) |
| phelix proxy | Operate the zero-downtime reverse proxy (start, status, stop, --foreground) |
| phelix dockerize <NAME> | Build and optionally publish Docker images; compose scaffolding |
| phelix matrix | Inspect and manage matrix runs: list, show, status, retry, init (see Matrix runs) |
| phelix deploy unlock | Interactive deploy unlock (also offered in the wizard) |
| phelix webhook | Run the foreground Git push webhook server (--host, --port); deploy exact pushed commits |
| phelix webhook status <app> | Inspect in-flight deployment jobs offline and read-only (--json) |
| phelix webhook history <app> | Inspect recent finished deployment jobs offline and read-only (--limit N) |
Configuration & diagnostics
| Command | Description |
|---|---|
| phelix init | Create phelix.yaml for the current project (--name, --port, --runtime, --yes) |
| phelix doctor | Diagnose project compatibility (PORT usage, config, toolchain) |
| phelix build-report <NAME> | Read-only inspection of stored build reports (--limit N) |
Security & monitoring
| Command | Description |
|---|---|
| phelix env | Manage encrypted app variables (set, get, list, unset, check) |
| phelix health | Configure and inspect health checks (set, add, list, remove, status) |
| phelix auth | Optional dashboard authentication (login, status, logout) |
| phelix monitor | Run the long-lived gRPC fleet monitoring daemon |
| phelix watch <NAME> | Opt one app in to (or out of) backend monitoring (--disable); disabled by default |
| phelix wizard | Guided interactive menu for every task |
Utility
phelix version [--short | --verbose]phelix update [--check] # update the Phelix binary to the latest releasephelix --helpEvery command exits with a stable, category-scoped exit code so automation can branch on failure mode. See Exit codes for the full mapping.