Skip to content

Service and Updates

Paulus1337 edited this page Jul 28, 2026 · 2 revisions

Service and updates

Run forever

phoenix service install

Installs a systemd service, starts it, and enables start at boot. First flight offers to do this for you once a channel is configured, and politely holds off if your old gateway is still running, so the two never fight over the same bot.

phoenix service status     # is it alive?
phoenix service logs       # what is it doing?
phoenix service restart
phoenix service uninstall

Secrets go in $PHOENIX_HOME/env, never into the unit file.

Stay current

phoenix update

Downloads the latest release for your platform, verifies the SHA-256 checksum, and swaps itself atomically. phoenix update --check only looks and tells you.

If a new binary ever misbehaves, the previous release is still on the Releases page.

Timers and heartbeat

Cron jobs run tasks on a schedule ([[jobs]] in the config, validate them with phoenix jobs), and a heartbeat can ping your chat on a fixed cadence so you know the bird still flies. Details: Configuration.

Housekeeping

phoenix doctor             # audit the setup
phoenix sessions           # stored conversations
phoenix tasks              # background work
phoenix secret set NAME    # encrypted secret store
phoenix schema             # the config contract, for editors and CI

Clone this wiki locally