​
What is BYOC?

BYOC (Bring Your Own Compute) means your data plane stays on infrastructure you control — or on an isolated instance Allternit provisions for your subscription. The public Cloud API at https://api.allternit.com is the control plane for every mode. The Allternit API binary is the data plane. It is never a second public hostname. You get:
  • Data stays on the node — sessions, files, and Office bindings live in per-instance SQLite
  • No inbound ports — the node opens an outbound WebSocket to the Cloud API
  • One public origin — browsers talk only to api.allternit.com
  • Same binary everywhere — local desktop, your VPS, or a provisioned instance

​
Architecture

​
Three modes

1. Local desktop

Allternit Desktop runs Allternit API and Gizzi on the user’s machine and pairs the node to the account.

2. User-paired VPS

You install the runtime on a box you own. Approve a pairing code. The node stays private.

3. Allternit-provisioned

Cloud API creates an isolated instance per subscription. Init installs Allternit API and auto-pairs. No inbound ports on the fleet host.
Mode 3 is the hosted data-plane lane (provisioned instances), distinct from Fly hosted runtimes which bundle a Gizzi gateway and agent-daemon as a managed machine.

​
Pair a node (mode 2)

  1. Start Allternit API and agent-daemon on the box (loopback only).
  2. The daemon creates a pairing: POST https://api.allternit.com/api/v1/runtime-pairings.
  3. Approve the user code at https://platform.allternit.com/pair.
  4. The node exchanges the pairing for a device token and connects:
  1. From then on, agent-sessions / office / beta calls to https://api.allternit.com relay to this node.
If nothing is paired and online, those routes return HTTP 428. Full protocol: Cloud API — runtime pairing.

​
System requirements

Supported: Linux (x86_64, ARM64), macOS 12+ (desktop). Provisioned fleet images are Linux x86_64.

​
Release channel

Provisioned instances and operators pull:
Desktop ships its own bundled Allternit API. Do not publish port 8013.

​
Next steps

Allternit API

Data-plane binary, local :8013, SQLite

Cloud API

Pairing, relay, provisioned instances

Hosted runtime

Managed Gizzi machine (Fly)