> ## Documentation Index
> Fetch the complete documentation index at: https://traceroot.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Self-Hosting

> Run TraceRoot on your own infrastructure

<Note>
  Prefer a managed solution? [TraceRoot Cloud](https://app.traceroot.ai) is maintained by the TraceRoot team — no setup required.
</Note>

TraceRoot is open source and supports self-hosting. Run it on your own infrastructure for full control over your data and deployment. Some features require an enterprise license key.

## Deployment Options

### Local Developer Deployment

Best for: contributing to TraceRoot, local development, and debugging.

Starts PostgreSQL, ClickHouse, MinIO, and Redis in Docker, then runs the API, UI, and workers locally via a tmux session.

```bash theme={null}
git clone https://github.com/traceroot-ai/traceroot.git
cd traceroot
make dev
```

<Frame>
  <img src="https://mintcdn.com/tracerootai/1DksdsEnLfyAboXR/images/local_dev_mode_v1.png?fit=max&auto=format&n=1DksdsEnLfyAboXR&q=85&s=d89639175b259cec0703ed3dcea0cb67" alt="TraceRoot local dev environment running in tmux" width="2956" height="1690" data-path="images/local_dev_mode_v1.png" />
</Frame>

See the [README](https://github.com/traceroot-ai/traceroot/blob/main/README.md) and [CONTRIBUTING.md](https://github.com/traceroot-ai/traceroot/blob/main/CONTRIBUTING.md) for details.

### Local Docker Deployment

Best for: trying TraceRoot locally, integration testing, or running a full stack without local dependencies.

Runs the entire stack in containers using Docker Compose — no need to install Python, Node, or other runtimes locally.

```bash theme={null}
git clone https://github.com/traceroot-ai/traceroot.git
cd traceroot
make prod
```

See the [README](https://github.com/traceroot-ai/traceroot/blob/main/README.md) for details.

### Production Deployment

Best for: production workloads on AWS.

Deploy TraceRoot on Kubernetes using Helm charts and Terraform. Configuration lives in the [`deploy`](https://github.com/traceroot-ai/traceroot/tree/main/deploy) directory.

<Warning>
  Terraform deployment is currently experimental. We recommend testing thoroughly before production use.
</Warning>