> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://www.comet.com/docs/opik/self-host/llms.txt.

# Self-hosting Opik

> Debug, evaluate, and monitor your LLM applications, RAG systems, and agentic workflows with comprehensive tracing, automated evaluations, and production-ready dashboards.

## Docs

- [Overview](https://www.comet.com/docs/opik/self-host/overview.md): Explore how to self-host Opik on your infrastructure with full feature access, including tracing and evaluation, without user management.
- [Migrating to Opik 2.0](https://www.comet.com/docs/opik/self-host/v1-to-v2-migration.md): Step-by-step guide for self-hosted Opik operators to run the background migration jobs that scope existing 1.x data to projects in Opik 2.0.
- [Local deployment](https://www.comet.com/docs/opik/self-host/local_deployment.md): Configure your local Opik deployment using Docker Compose for quick setup. Ideal for testing but not for production environments.
- [Kubernetes deployment](https://www.comet.com/docs/opik/self-host/kubernetes.md): Learn to configure and deploy Opik on Kubernetes using our Helm chart for robust, production-ready environments.
- [Migrating from Bitnami Charts and Images](https://www.comet.com/docs/opik/self-host/helm.md): Learn how to migrate from Bitnami charts and images to Opik's official Helm chart
- [ClickHouse Cold-Tier Migration](https://www.comet.com/docs/opik/self-host/clickhouse-cold-tier-migration.md): How the Opik Helm chart automatically recovers ClickHouse when the cold storage tier is enabled on a multi-replica cluster
- [ClickHouse Tiered-Storage TTL and Backfill](https://www.comet.com/docs/opik/self-host/clickhouse-tiered-storage-ttl.md): How the Opik Helm chart moves old trace data to the ClickHouse cold tier, and how to backfill existing data safely
- [Platform Architecture](https://www.comet.com/docs/opik/self-host/architecture.md): Learn how Opik's architecture utilizes multiple services for backend, frontend, and data management, optimizing performance and scalability.
- [Scaling Opik](https://www.comet.com/docs/opik/self-host/scaling.md): Learn best practices and configurations for running Opik in production, ensuring resilience and scalability for mission-critical workloads.
- [Advanced clickhouse backup](https://www.comet.com/docs/opik/self-host/backup.md): Learn to implement SQL-based and dedicated backup tools for ClickHouse in Opik's Kubernetes setup to ensure data protection and recovery.
- [Troubleshooting](https://www.comet.com/docs/opik/self-host/troubleshooting.md): Troubleshooting guide for common issues when running self-hosted Opik deployments.
- [Self-host changelog](https://www.comet.com/docs/opik/self-host/changelog.md): Breaking and critical changes for self-hosted Opik deployments
- [Anonymous usage statistics](https://www.comet.com/docs/opik/self-host/configure/anonymous_usage_statistics.md): Learn how to enable or disable anonymous usage statistics reporting in Opik to improve platform performance and user experience.
- [Large CSV uploads](https://www.comet.com/docs/opik/self-host/configure/large_csv_uploads.md): Configure Opik to accept CSV uploads up to 2GB, enabling efficient dataset creation and asynchronous processing.
- [Dataset versioning migration](https://www.comet.com/docs/opik/self-host/configure/dataset_versioning_migration.md): Learn about the automated dataset versioning migration process when upgrading to Opik 1.9.92 or higher, including configuration, monitoring, and recovery steps.
- [LLM model registry](https://www.comet.com/docs/opik/self-host/configure/llm-model-registry.md)
- [UUIDv7 ingestion validation](https://www.comet.com/docs/opik/self-host/configure/uuid_validation.md): Turn on UUIDv7 ingestion validation in Opik — the window, audit (shadow) mode, and the kill-switch — and check your clients before enabling it.
- [Querying trace data in ClickHouse](https://www.comet.com/docs/opik/self-host/configure/traces-storage.md): How the traces table stores missing values and timestamps, and how to write ad-hoc SQL, dashboards and BI queries that stay correct.
- [MCP OAuth](https://www.comet.com/docs/opik/self-host/configure/mcp-oauth.md): Turn on the MCP OAuth authorization server so coding agents can connect to a self-hosted Opik deployment with browser sign-in instead of a stored API key.