Services

A service is described by a manifest.toml. hamctl ships with manifests for the AFRN client and the Pi-Star digital-voice stack, and you can add your own without recompiling.

Categories

A manifest’s category decides where it appears in the sidebar:

  • category = "service" (the default) puts it under Services.
  • category = "os" puts it under OS Configuration, for host-level settings that aren’t ham radio services. WiFi (wpa-supplicant) lives there.

Only installed services are shown

The shipped manifests are a catalog; a service appears in the UI only once it’s installed, meaning its files are present on disk. That means the [run] binary resolves, or for externally-managed services like the Pi-Star stack, its config file exists under config_root. Until then it’s hidden from the sidebar and dashboard, and listed under “Available to install” with its install command.

See Installing payloads for how hamctl install <id> fetches or builds a service.

Shipped services

  • AFRN — the AlterFRN gateway client.
  • Pi-Star stack — MMDVMHost plus the mode gateways and bridges.

Table of contents