Download

Download orch

One server for the team, then one agent on each member's machine.

Get the server files

Point a DNS record at the host first: Caddy requests its certificate on the first start.

$ git clone https://github.com/selfhostr/orch.git
$ cd orch/deploy/server
$ cp .env.example .env  # fill it in

Create the GitHub App
Put its identifiers in .env and its private key in secrets/github-app.pem. The steps are in the docs.
Start the server
This pulls the images and applies the migrations.
```
$ docker compose up -d
$ curl -fsS https://<domain>/healthz
```
Add each member
The My Server page gives each member this command with a one-time token, valid 15 minutes.
```
$ curl -fsSL https://<domain>/install.sh | ORCH_TOKEN=<one-time-token> sh
$ orch login
```
Connect Claude Code, if you want
Then run /mcp, pick orch and choose Authenticate.
```
$ claude mcp add --transport http --scope user orch https://<domain>/mcp
```

Server: a Linux host with Docker Engine 26+ and Compose, ports 80 and 443 reachable, and a DNS name
Each member: Docker Engine 26+, curl, sh and their own Claude subscription
A GitHub App for sign-in, webhooks and pull requests

Latest releasev0.9.1
Imagesghcr.io/selfhostr/orch-server, ghcr.io/selfhostr/orch-web, ghcr.io/selfhostr/orch-agent
Platformslinux/amd64, linux/arm64
Pin a versionORCH_VERSION
Updategit pull && docker compose pull && docker compose up -d

Every selfhostr project is free and has no company behind it. If one saves you time, a donation pays for the test hardware and for the time it takes.

Check the first and last characters after pasting. We never ask for crypto by message.