> ## Documentation Index > Fetch the complete documentation index at: https://tracevell.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Self-hosting Tracevell Tracevell is [open-source](https://github.com/lmnr-ai/lmnr), so you can run the full observability and debugging stack in your own infrastructure. Self-host with [Docker Compose](https://tracevell.com/docs/self-hosting/docker-compose.md) for local and single-node setups, or the [Kubernetes Helm chart](https://tracevell.com/docs/self-hosting/kubernetes.md) for production. Docker Compose runs a lightweight stack (frontend, app server, PostgreSQL, ClickHouse, and Quickwit); the Helm chart runs the full production stack, adding RabbitMQ, Redis, and a dedicated processing consumer. ## OSS, Helm, or Tracevell Cloud There are four ways to run Tracevell, and they differ only in how Signals and Slack are packaged and in the support that comes with them. Everything else (tracing, search, dashboards, evaluations, the debugger, AI features) is identical across all of them. * **OSS**: the [open-source images](https://github.com/lmnr-ai/lmnr), run with [Docker Compose](https://tracevell.com/docs/self-hosting/docker-compose.md). Signals and the Slack integration are not included. * **Helm**: the [Kubernetes Helm chart](https://tracevell.com/docs/self-hosting/kubernetes.md). The same platform as OSS, packaged for production Kubernetes. * **Helm + license**: the same chart with an [enterprise license key](mailto:jacob@tracevell.com). Unlocks Signals, signal event clusters, and email and Slack alerts, plus priority support and the option to have the Tracevell team run your deployment for you (see [Managed self-hosting](#managed-self-hosting)). * **Tracevell Cloud**: the fully managed service at [tracevell.com](https://tracevell.com). Everything is included and kept up to date for you. ### Feature comparison | Tracing & platform | OSS | Helm | Helm + license | Tracevell Cloud | | - | :-: | :-: | :-: | :-: | | Trace ingestion (OTLP) | ✓ | ✓ | ✓ | ✓ | | Full-text trace search | ✓ | ✓ | ✓ | ✓ | | Custom dashboards | ✓ | ✓ | ✓ | ✓ | | SQL editor | ✓ | ✓ | ✓ | ✓ | | CLI | ✓ | ✓ | ✓ | ✓ | | Evaluations | ✓ | ✓ | ✓ | ✓ | | Datasets | ✓ | ✓ | ✓ | ✓ | | Labeling queues | ✓ | ✓ | ✓ | ✓ | | Browser session recording | ✓ | ✓ | ✓ | ✓ | | Agent debugger | ✓ | ✓ | ✓ | ✓ | | MCP access | ✓ | ✓ | ✓ | ✓ | | AI features | OSS | Helm | Helm + license | Tracevell Cloud | | - | :-: | :-: | :-: | :-: | | Chat-with-trace | ✓ | ✓ | ✓ | ✓ | | SQL-with-AI | ✓ | ✓ | ✓ | ✓ | | [Signals](https://tracevell.com/docs/signals/introduction.md) | - | - | ✓ | ✓ | | Signal event clusters | - | - | ✓ | ✓ | | Alerting & integrations | OSS | Helm | Helm + license | Tracevell Cloud | | - | :-: | :-: | :-: | :-: | | Email alerts | - | - | ✓ | ✓ | | [Slack](https://tracevell.com/docs/signals/alerts.md) notifications and alerts | - | - | ✓ | ✓ | | Security & operations | OSS | Helm | Helm + license | Tracevell Cloud | | - | :-: | :-: | :-: | :-: | | OAuth sign-in (GitHub, Google, Azure AD, Okta, Keycloak) | ✓ | ✓ | ✓ | ✓ | | [Server-side PII redaction](https://tracevell.com/docs/self-hosting/configuration.md#pii-redaction) | ✓ | ✓ | ✓ | ✓ | | Data stays in your infrastructure | ✓ | ✓ | ✓ | - | | Managed upgrades | - | - | ✓ | ✓ | | Support | OSS | Helm | Helm + license | Tracevell Cloud | | - | :-: | :-: | :-: | :-: | | Community (Discord) | ✓ | ✓ | ✓ | ✓ | | Priority support | - | - | ✓ | ✓ | | Operated for you by the Tracevell team | - | - | ✓ | - | > [!NOTE] > > Signals, signal event clusters, and email and Slack alerts require an enterprise license key (`LMNR_LICENSE_KEY`). The Slack integration additionally uses Tracevell Cloud's brokered OAuth flow. See the [configuration reference](https://tracevell.com/docs/self-hosting/configuration.md#slack-notifications) for details. > > AI features (chat-with-trace, SQL-with-AI, and Signals) need an LLM provider key on self-hosted deployments; on Tracevell Cloud they are included. See [AI features and LLM provider](https://tracevell.com/docs/self-hosting/configuration.md#ai-features-and-llm-provider). ## Managed self-hosting With an enterprise license key, the Tracevell team can take care of running your self-hosted deployment for you. We operate it inside your own AWS or GCP account, close to a forward-deployed model: your data and the entire stack stay in your infrastructure, while we handle provisioning, scaling, upgrades, and day-to-day operations under scoped access to your environment. This is the option for teams that want the data-residency and compliance benefits of self-hosting without standing up and maintaining the platform themselves. [Contact us](mailto:jacob@tracevell.com) to set it up. If you just want to start tracing, [Tracevell Cloud](https://tracevell.com) is the fastest path: sign up, create a project, copy the project API key, and set `LMNR_PROJECT_API_KEY`. The rest of this section covers running Tracevell yourself. ## Choose a deployment > [card] [Docker Compose](https://tracevell.com/docs/self-hosting/docker-compose.md) > > Single-node setup for local development and small deployments. One command brings up the whole stack. > [card] [Kubernetes (Helm)](https://tracevell.com/docs/self-hosting/kubernetes.md) > > Production deployments on EKS or GKE. Persistent storage, S3-backed ClickHouse, load balancers, and TLS. ## Configure your deployment The Helm chart exposes every paid and optional feature through values in `tracevell.yaml`. See the [configuration reference](https://tracevell.com/docs/self-hosting/configuration.md) for the full surface: * **[AI features](https://tracevell.com/docs/self-hosting/configuration.md#ai-features-and-llm-provider)**: chat-with-trace, SQL-with-AI, and Signals all run through one LLM provider (Gemini, OpenAI, or Bedrock). * **[Signals](https://tracevell.com/docs/self-hosting/configuration.md#signals)**: natural-language outcome and failure extraction, on by default once an LLM key is set. * **[Slack notifications](https://tracevell.com/docs/self-hosting/configuration.md#slack-notifications)**: brokered through Tracevell Cloud with an enterprise license key. * **[OAuth login](https://tracevell.com/docs/self-hosting/configuration.md#oauth-login)**: GitHub, Google, Azure AD, Okta, and Keycloak. * **[Storage](https://tracevell.com/docs/self-hosting/configuration.md#storage)**, **[TLS and ingress](https://tracevell.com/docs/self-hosting/configuration.md#tls-and-ingress)**, **[PII redaction](https://tracevell.com/docs/self-hosting/configuration.md#pii-redaction)**, **[secrets management](https://tracevell.com/docs/self-hosting/configuration.md#secrets-management)**, and **[image pinning](https://tracevell.com/docs/self-hosting/configuration.md#container-images)**. ## What's next > [card] [Start tracing](https://tracevell.com/docs/tracing/introduction.md) > > Point the SDK at your instance and send your first traces. > [card] [View traces](https://tracevell.com/docs/platform/viewing-traces.md) > > Read the transcript view instead of a tree of span names. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.