Install

Install

Pick one. All roads end with a phoenix command that works.

Download (easiest)

Grab the file for your machine from Releases:

Your machine	File
Linux (normal PC/server)	phoenix-linux-x86_64
Linux (Raspberry Pi 4/5, ARM servers)	phoenix-linux-arm64
Mac (M1/M2/M3/M4)	phoenix-macos-arm64
Mac (Intel)	phoenix-macos-x86_64
Windows	phoenix-windows-x86_64.exe

Then make it runnable and put it on your PATH:

chmod +x phoenix-linux-x86_64
sudo mv phoenix-linux-x86_64 /usr/local/bin/phoenix

Debian / Ubuntu / Kali

sudo dpkg -i openphoenix_0.0.1_amd64.deb

Docker

The image defaults to serve, so set up first, then run:

docker run --rm -v phoenix-data:/data \
  ghcr.io/paulus1337/openphoenix init          # writes /data/.openphoenix/config.toml

docker run -it --rm -v phoenix-data:/data \
  -e PHOENIX_API_KEY=your-key \
  ghcr.io/paulus1337/openphoenix chat          # talk to it

docker run -d -v phoenix-data:/data \
  -e PHOENIX_API_KEY=your-key \
  ghcr.io/paulus1337/openphoenix               # serve, the default

Everything lives in the /data volume: config, memory, sessions. The image is built from scratch with no shell inside, so the shell tool is unavailable there; file tools still work.

Verify (optional, recommended)

SHA256SUMS is attached to every release:

sha256sum -c SHA256SUMS --ignore-missing

Next: Quickstart.