Status: Implementation IMPLEMENTED × Exposure PUBLIC PREVIEW. Earlier versions of this page described an allternit-runtime binary, install.allternit.com and dl.allternit.com downloads, and port 8080. None of these exist in the code on main.
The data plane is allternit-api (cmd/allternit-api). Pairing is done by agent-daemon (cmd/agent-daemon, @allternit/agent-daemon). See BYOC Overview.

​
Get the binary

Provisioned and fleet instances pull the release tarball:
Only linux-x86_64 is referenced by the provisioning code. Desktop bundles its own allternit-api build. To build from source: cargo build --release -p allternit-api.

​
Run allternit-api

  • ALLTERNIT_API_PORT sets the listen port. If unset it defaults to the dev port 18013; production owners pin 8013.
  • The listener binds 0.0.0.0:<port>, not loopback. Firewall the port or put it behind a private interface. Do not publish it.
  • Health: GET /health, GET /health/live, GET /health/ready.

​
Pair with the Cloud API

The daemon prints a verification URL and a user code. Approve it at https://platform.allternit.com/pair. It then exchanges the pairing (POST /api/v1/runtime-pairings/exchange) and connects to wss://api.allternit.com/api/v1/runtime-relay/connect/:runtimeId. Alternatively the Deploy Wizard provisions and bootstraps a VPS for you.

​
Process supervision

Run both processes under your service manager (systemd, launchd). Neither ships a unit file; write your own with the environment above.

​
How this relates to the Agency Kernel

BYOC is where the Allternit API data plane and Gizzi runtime run on hardware you control. The Agency Kernel contracts are served through the Cloud API. Nothing on this page changes them.