Version 1.2.0
Phelix documentation
Build, run, deploy, and monitor Go and Rust applications across one machine or an entire server fleet.
What is Phelix?
Phelix helps you build, deploy, and care for Go and Rust applications on servers you control. Keep track of releases, protect configuration, check application health, and return to a previous version when needed. Linux is the primary supported platform; Windows support is experimental.
You can also let an AI agent help with deployment, with changes checked against your approval rules. Saved sessions help you review what happened after an interruption. For larger projects, use workspacesto release related services together and background workers to handle tasks outside incoming web requests.
Quick start
Create a project configuration, build your app, and check its status. The later examples show how to release an update, recover a previous version, and manage related services together.
phelix init
phelix build myapp --port 8080
phelix rebuild myapp
phelix stop myapp
phelix rebuild myapp --blue-green
phelix rebuild myapp --canary 5
phelix doctor
phelix list
phelix rollback myapp
phelix build --all
phelix deploy --all
phelix status --workspaceCore workflow
- BuildAuto-detect Go or Rust, compile the project, create a numbered version, record a Build Report, and start the app.
- DeployUse classic replacement, blue-green switching, rolling replicas, or verified canary and progressive rollouts.
- ObserveInspect status, logs, health checks, server metrics, and proxy routing.
- RecoverRoll back to a retained version and restore its paired encrypted environment snapshot.
A typical lifecycle: build then optional zero-downtime rebuild, with rollback as the safety net and stop / remove to retire an app. Every build is versioned (v1, v2, ...) and can be tagged.
Capabilities
| Area | Included in v1.2.0 |
|---|---|
| Runtime | Go and Rust auto-detection |
| Deployments | Classic, blue-green, rolling, canary, and progressive |
| Workers | Supervised background workloads: restart policies, exec probes, replica scaling, rolling replacement |
| Workspaces | Monorepo deploys as one unit: dependency-ordered builds, mesh-wide rollback |
| Recovery | Versioned binaries, tags, dry-run previews, and audited rollback |
| Security | AES-256-GCM environment and registry credentials |
| Build intelligence | Automatic build reports and regression alerts, fully offline |
| Distribution | Docker, Compose, and matrix builds with release manifests |
| Docker runtime | Run app instances as containers under the zero-downtime proxy |
| Operations | Health checks, logs, proxy, and opt-in multi-server monitoring |
| Resource control | Per-instance CPU and memory limits via cgroups v2 (Linux) |
| Git webhooks | HMAC-authenticated pushes deploy exact commits with durable job history |
| Automation & agents | MCP adapter, agent execution sessions, and two-step plan-based execution |
| Authorization | Optional fail-closed execution gate with plan-bound, human-signed approvals |
| Machine interface | A versioned --json envelope on every core command, for scripts and agents |