orch
PT-BR
GitHub Instalar

Baixar

Baixar orch

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

  1. Baixar os arquivos do servidor

    Primeiro aponte um registro DNS para o host: o Caddy pede o certificado na primeira inicialização.

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

  2. Criar o 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

    Isso baixa 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 uso único, válido por 15 minutos.

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

  5. Conectar 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: um host 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 própria assinatura do Claude
  • Um GitHub App para login, 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

Todo projeto selfhostr é gratuito e não tem nenhuma empresa por trás. Se algum economiza seu tempo, uma doação paga o hardware de teste e o tempo dedicado.

Nos patrocine no GitHub