Skip to main content
OpenLIT is open source and is lightweight to self-host. You need two components:
  1. OpenLIT — dashboard, APIs, and the first-party OTLP receiver (:4317 gRPC, :4318 HTTP)
  2. ClickHouse — storage for traces, metrics, and logs (otel_* tables)
Already have ClickHouse?You can reuse it and skip deploying a new database. OpenLIT connects through INIT_DB_* or a project database config. You do not need a bundled OpenTelemetry Collector — OTLP ingest is built into the OpenLIT container. An optional sidecar Collector can still forward OTLP to OpenLIT.
This section contains guides for different deployment scenarios.

Kubernetes

Deploy OpenLIT and ClickHouse on Kubernetes. OTLP ingest is built into the OpenLIT container.

Docker

Deploy OpenLIT and ClickHouse with Docker Compose. Ports 3000, 4317, and 4318 are on the OpenLIT service.

​
Kubernetes

Deploy OpenLIT on your Kubernetes cluster using the OpenLIT Helm chart. The chart deploys the OpenLIT platform (including the OTLP receiver) and ClickHouse.
1

Helm Repo Setup

shell
2

Installing the Helm Chart

shell
Send OTLP to the OpenLIT service on 4317 (gRPC) or 4318 (HTTP). See OTLP receiver.

​
Docker

For a quick setup, Docker Compose deploys OpenLIT and ClickHouse. The OpenLIT container listens on 3000 (UI), 4317 (OTLP/gRPC), and 4318 (OTLP/HTTP). There is no separate otel-collector service.
1

Git Clone OpenLIT Repository

2

Start Docker Compose

From the root directory of the OpenLIT Repo, Run the below command
If you previously ran the old stack, restart Compose with --remove-orphans. The standalone otel-collector container is no longer used and will conflict on ports 4317 and 4318 if it is left running.

​
Frequently asked questions

Docker and Docker Compose for the quickest path, or a Kubernetes cluster with Helm. Both deploy OpenLIT (dashboard + OTLP receiver) and ClickHouse.
Yes for ClickHouse — see Connect Multiple Databases. You do not need OpenLIT to run otelcol. If you already operate a Collector, forward OTLP to OpenLIT.
Yes. OpenLIT is licensed under Apache-2.0 and the community edition is free to self-host, with no license key or usage limits. A few organisation-wide governance features, such as custom roles, audit logs, and alerts, are part of OpenLIT Enterprise and are marked with an Enterprise tag in these docs.

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