Skip to content

Command Palette

Search for a command to run...

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.

Terminal
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 --workspace

Core workflow

  1. Build
    Auto-detect Go or Rust, compile the project, create a numbered version, record a Build Report, and start the app.
  2. Deploy
    Use classic replacement, blue-green switching, rolling replicas, or verified canary and progressive rollouts.
  3. Observe
    Inspect status, logs, health checks, server metrics, and proxy routing.
  4. Recover
    Roll 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

AreaIncluded in v1.2.0
RuntimeGo and Rust auto-detection
DeploymentsClassic, blue-green, rolling, canary, and progressive
WorkersSupervised background workloads: restart policies, exec probes, replica scaling, rolling replacement
WorkspacesMonorepo deploys as one unit: dependency-ordered builds, mesh-wide rollback
RecoveryVersioned binaries, tags, dry-run previews, and audited rollback
SecurityAES-256-GCM environment and registry credentials
Build intelligenceAutomatic build reports and regression alerts, fully offline
DistributionDocker, Compose, and matrix builds with release manifests
Docker runtimeRun app instances as containers under the zero-downtime proxy
OperationsHealth checks, logs, proxy, and opt-in multi-server monitoring
Resource controlPer-instance CPU and memory limits via cgroups v2 (Linux)
Git webhooksHMAC-authenticated pushes deploy exact commits with durable job history
Automation & agentsMCP adapter, agent execution sessions, and two-step plan-based execution
AuthorizationOptional fail-closed execution gate with plan-bound, human-signed approvals
Machine interfaceA versioned --json envelope on every core command, for scripts and agents