orch

Scarica

Scarica orch

Un server per il team, poi un agente sulla macchina di ogni membro.

  1. Scaricare i file del server

    Prima punta un record DNS verso l'host: Caddy richiede il certificato al primo avvio.

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

    Metti i suoi identificativi in .env e la chiave privata in secrets/github-app.pem. I passaggi sono nella documentazione.

  3. Avviare il server

    Scarica le immagini e applica le migrazioni.

    $ docker compose up -d
    $ curl -fsS https://<domain>/healthz
  4. Aggiungere ogni membro

    La pagina My Server dà a ogni membro questo comando con un token monouso, valido 15 minuti.

    $ curl -fsSL https://<domain>/install.sh | ORCH_TOKEN=<one-time-token> sh
    $ orch login
  5. Collegare Claude Code, se vuoi

    Poi esegui /mcp, scegli orch e poi Authenticate.

    $ claude mcp add --transport http --scope user orch https://<domain>/mcp

Requisiti

  • Server: un host Linux con Docker Engine 26+ e Compose, porte 80 e 443 raggiungibili e un nome DNS
  • Ogni membro: Docker Engine 26+, curl, sh e il proprio abbonamento Claude
  • Una GitHub App per accesso, webhook e pull request

Versioni e immagini

  • Ultima versionev0.9.1
  • Immaginighcr.io/selfhostr/orch-server, ghcr.io/selfhostr/orch-web, ghcr.io/selfhostr/orch-agent
  • Piattaformelinux/amd64, linux/arm64
  • Fissare una versioneORCH_VERSION
  • Aggiornagit pull && docker compose pull && docker compose up -d

Sostieni il progetto

Ogni progetto selfhostr è gratuito e non ha un'azienda alle spalle. Se uno ti fa risparmiare tempo, una donazione paga l'hardware di prova e il tempo impiegato.

Sponsorizzaci su GitHub