Okapi documentation

Okapi is an OpenTelemetry-native observability platform for metrics, logs, and traces, with ClickHouse-backed storage and Oscar, an AI-assisted investigation service.

This documentation is written for the people who install and operate Okapi. Start with Choose an installation path if you are evaluating Okapi, or go directly to Kubernetes installation for a production-oriented deployment.

Documentation map

• Getting started — choose a deployment model and understand the prerequisites.
• Architecture — understand the services, data paths, and storage boundaries.
• Installation — install locally with Docker or on Kubernetes.
• okapictl — use the supported command-line installer and demo runner.
• Helm reference — deploy and tune the individual charts.
• Telemetry — configure OpenTelemetry clients and optional Kafka ingestion.
• Operations — validate, scale, upgrade, back up, and troubleshoot a deployment.