Getting started

Installation

Install the Phelix binary, monitoring service, and optional runtime toolchains.

One-line installer

The recommended installer detects the operating system and architecture, downloads the matching prebuilt binary, installs it to /usr/local/bin/phelix, and — on Linux — registers and enables a phelix.service systemd unit.

Terminal

curl -fsSL https://phelix.anophel.com/install.sh | bash

Monitor service

The systemd unit runs phelix monitor directly in the foreground (as ExecStart) — there is no backgrounding shell wrapper. On boot the daemon restores every managed app that was previously running, then keeps a persistent, TLS-secured gRPC connection to the backend, reconnecting with exponential backoff.

Terminal

sudo systemctl start phelix
sudo systemctl restart phelix
sudo systemctl stop phelix
sudo systemctl status phelix
sudo journalctl -u phelix -f

Verify installation

Terminal

phelix version
sudo systemctl status phelix

Runtime dependencies

Dependency	Required when
Go toolchain	Building Go applications
Rust + Cargo	Building Rust applications
Docker	Using dockerize, Rust cross, or multi-version matrix builds
Internet access	Authentication, downloads, and monitoring sync

Supported platforms

Linux is the primary target. Windows support is experimental. Matrix output supports Linux, macOS, and Windows targets depending on language and architecture.