orch
PT
GitHub Instalar

Transferir

Transferir orch

Um servidor para a equipa e um agente na máquina de cada membro.

  1. Obter os ficheiros do servidor

    Primeiro aponte um registo DNS para o servidor: o Caddy pede o certificado no primeiro arranque.

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

  2. Criar a GitHub App

    Coloque os identificadores em .env e a chave privada em secrets/github-app.pem. Os passos estão na documentação.

  3. Iniciar o servidor

    Isto obtém as imagens e aplica as migrações.

    $ docker compose up -d
$ curl -fsS https://<domain>/healthz

  4. Adicionar cada membro

    A página My Server dá a cada membro este comando com um token de utilização única, válido 15 minutos.

    $ curl -fsSL https://<domain>/install.sh | ORCH_TOKEN=<one-time-token> sh
$ orch login

  5. Ligar o Claude Code, se quiser

    Depois execute /mcp, escolha orch e Authenticate.

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

Requisitos

  • Servidor: uma máquina Linux com Docker Engine 26+ e Compose, portas 80 e 443 acessíveis, e um nome DNS
  • Cada membro: Docker Engine 26+, curl, sh e a sua própria subscrição Claude
  • Uma GitHub App para início de sessão, webhooks e pull requests

Versões e imagens

  • Última versãov0.9.1
  • Imagensghcr.io/selfhostr/orch-server, ghcr.io/selfhostr/orch-web, ghcr.io/selfhostr/orch-agent
  • Plataformaslinux/amd64, linux/arm64
  • Fixar uma versãoORCH_VERSION
  • Atualizargit pull && docker compose pull && docker compose up -d

Apoiar o projeto

Todos os projetos selfhostr são gratuitos e não têm nenhuma empresa por trás. Se algum lhe poupa tempo, um donativo paga o hardware de teste e o tempo dedicado.

Patrocine-nos no GitHub