Ways to run Orbi

The self-hosted runner is the open-source core and runs on your own machine against your own GitHub repositories. Orbi Managed Cloud is the commercial hosted control plane on the same GitHub ledger.

Path	Use when	Action	Detail
Managed Cloud	You want deliveries running without operating a runner machine yourself	Sign in at orbi.build/cloud	Hosted control plane on the same GitHub ledger; nothing to install
Installer (recommended self-hosted path)	Linux with a systemd user session, or macOS with launchd	`curl -LsSf https://raw.githubusercontent.com/orbi-build/orbi/main/install.sh \| bash`	Getting started
PyPI (`orbi-cli`)	You only want the `orbi` CLI, Python ≥ 3.14	`uv tool install orbi-cli`	Getting started
Docker (community)	Host has no systemd user session	`docker pull ghcr.io/orbi-build/orbi:latest`	Docker

Three caveats keep the choice honest:

Managed Cloud and a self-hosted runner must not both serve the same task pool — pick one, never both.
PyPI gives you the orbi command only; running Orbi itself uses the installer or the editable checkout install.
Docker is community-maintained and unofficial; on a host that has a systemd user session the official installer path is preferred — pick one of the two, never both for the same task pool.