Documentation navigation
Getting started Quickstart Installation Core concepts Product tour
Building trees Creating nodes Prompt blocks Connectors Roles and governance Skills Co-pilot Collaboration
Run and inspect Execution Runs and traces Versions and rollback
SDK Python SDK Node.js SDK
Integrate API MCP and bundles
Providers AI connections Hosted providers for testing
Deploy Self-hosting Orchetree Cloud Environment variables

Self-hosting

Docker Compose

cp .env.example .env
docker compose up --build

The default profile starts the frontend at http://localhost:5173 and publishes the backend on host port 8001. PostgreSQL data is persisted in the orchetree-pgdata Docker volume.

Headless backend

source .venv/bin/activate
PYTHONPATH=src .venv/bin/uvicorn backend.main:app \
  --host 0.0.0.0 \
  --port 8000

A headless deployment exposes GraphQL, REST, and MCP without shipping the authoring frontend.

For production, place the backend behind TLS, use an external secrets manager, configure persistent storage, protect MCP with MCP_API_KEY, and restrict CORS through the application settings.