orch
ES
GitHub Instalar

Descargar

Descargar orch

Un servidor para el equipo y un agente en la máquina de cada miembro.

  1. Obtener los archivos del servidor

    Primero apunta un registro DNS al servidor: Caddy pide su certificado en el primer arranque.

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

  2. Crear la GitHub App

    Pon sus identificadores en .env y su clave privada en secrets/github-app.pem. Los pasos están en la documentación.

  3. Iniciar el servidor

    Esto descarga las imágenes y aplica las migraciones.

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

  4. Añadir a cada miembro

    La página My Server da a cada miembro este comando con un token de un solo uso, válido 15 minutos.

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

  5. Conectar Claude Code, si quieres

    Después ejecuta /mcp, elige orch y luego Authenticate.

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

Requisitos

  • Servidor: una máquina Linux con Docker Engine 26+ y Compose, puertos 80 y 443 accesibles, y un nombre DNS
  • Cada miembro: Docker Engine 26+, curl, sh y su propia suscripción a Claude
  • Una GitHub App para el inicio de sesión, los webhooks y las pull requests

Versiones e imágenes

  • Última versiónv0.9.1
  • Imágenesghcr.io/selfhostr/orch-server, ghcr.io/selfhostr/orch-web, ghcr.io/selfhostr/orch-agent
  • Plataformaslinux/amd64, linux/arm64
  • Fijar una versiónORCH_VERSION
  • Actualizargit pull && docker compose pull && docker compose up -d

Apoyar el proyecto

Todos los proyectos de selfhostr son gratuitos y no tienen ninguna empresa detrás. Si alguno te ahorra tiempo, una donación paga el hardware de pruebas y el tiempo dedicado.

Patrocínanos en GitHub