> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orbi.build/llms.txt
> Use this file to discover all available pages before exploring further.

> How do I install Orbi?

# Installation

# 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](https://orbi.build/cloud/?ref=docs-installation)         | 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](/getting-started)                                |
| PyPI (`orbi-cli`)                        | You only want the `orbi` CLI, Python ≥ 3.14                             | `uv tool install orbi-cli`                                                             | [Getting started](/getting-started#pypi-installation)              |
| Docker (community)                       | Host has no systemd user session                                        | `docker pull ghcr.io/orbi-build/orbi:latest`                                           | [Docker](/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.