Core workflow
Build and lifecycle
Turn source code into a managed process, then control its complete runtime lifecycle.
Build an application
Phelix inspects the current directory for go.mod or Cargo.toml, compiles the project, starts it, and records a new version.
phelix build myapp -p 8080 --tag "v1.2.3"| Flag | Default | Purpose |
|---|---|---|
| --port, -p | 8080 | Application port |
| --build-arg, -a | — | Repeatable build-tool arguments |
| --tag | — | Human-readable version label |
| --no-upload | false | Skip central server sync |
| --debug | false | Verbose build output |
| --matrix | false | Matrix mode: versions × platforms |
| --go-versions / --rust-versions | — | Toolchain versions, e.g. 1.22,1.23 |
| --platforms | — | Targets, e.g. linux/amd64,linux/arm64 |
| --matrix-concurrency | 4 | Max parallel matrix builds |
| --matrix-dry-run | false | Print the plan without building |
Rebuild after changes
phelix rebuild myapp --blue-green
phelix rebuild myapp --replicas 3--blue-green performs a zero-downtime switch, and --replicas N rolls N replicas one at a time. Both auto-start the proxy daemon if it is not running.
Lifecycle commands
| Command | Behavior |
|---|---|
| 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, version, deploy mode, and proxy routing. |
| phelix list | Table of every managed app with version, status, 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. |