Self-Host OpenLIT

Self-host OpenLIT with Docker or Kubernetes. Deploy OpenLIT, ClickHouse, and an OpenTelemetry Collector on your own infrastructure.

OpenLIT is open source and is very easy and lightweight to self-host as it needs only 3 components to run:

1. OpenLIT itself
2. ClickHouse for storage
3. OpenTelemetry Collector for telemetry collection.

Already have ClickHouse or OpenTelemetry Collector?

You can reuse your existing infrastructure and skip deploying these components. OpenLIT can be configured to connect to your existing ClickHouse database and OTel Collector setup. Learn more about connecting to existing databases →

This section contains guides for different deployment scenarios.

Kubernetes

Deploy OpenLIT’s lightweight 3-component architecture on Kubernetes for scalable AI Engineering capabilities.

Docker

Deploy OpenLIT’s lightweight 3-component stack using Docker for an easy-to-manage AI Engineering setup.

Kubernetes

Deploy OpenLIT on your Kubernetes cluster using the OpenLIT Helm chart. The Helm chart deploys all 3 components (OpenLIT platform, ClickHouse, and OpenTelemetry Collector) for a reliable and scalable solution.

1. Helm Repo Setup

   shell

   helm repo add openlit https://openlit.github.io/helm/
   helm repo update
   
2. Installing the Helm Chart

   shell

   helm install openlit openlit/openlit
   

Docker

For a quick and straightforward setup, Docker Compose can be used to deploy OpenLIT’s complete stack: the OpenLIT platform, ClickHouse database, and OpenTelemetry Collector.

1. Git Clone OpenLIT Repository

   git clone [e-mail]:openlit/openlit.git
   
2. Start Docker Compose

   From the root directory of the OpenLIT Repo, Run the below command

   docker compose up -d
   

Frequently asked questions

What do I need to self-host OpenLIT?

Just Docker and Docker Compose for the quickest path, or a Kubernetes cluster with Helm if you’re deploying at scale. Both methods deploy the same 3 components: OpenLIT, ClickHouse, and an OpenTelemetry Collector.

Can I reuse my existing ClickHouse or OpenTelemetry Collector?

Yes. OpenLIT can connect to infrastructure you already run instead of deploying its own ClickHouse or OTel Collector. See Connect Multiple Databases for setup.

Is OpenLIT free to self-host?

Yes. OpenLIT is licensed under Apache-2.0 - every feature in this documentation is free to self-host, with no license key or usage limits.

---

Start tracing

Production-ready AI monitoring setup in 2 simple steps with zero code changes

Use prompt management

Version, deploy, and collaborate on prompts with centralized management and tracking

Set up evals

Score live traces automatically with prebuilt LLM-as-a-judge evaluators