🏁 Get Started with Gigapipe Open-Source
Gigapipe is a lightweight, multi-standard observability OSS stack - just add data ☘️
Step 1: Install Gigapipe Open-Source
Deploy Gigapipe on your infrastructure using Docker, Kubernetes, or static binaries
🐳 Docker Container
ghcr.io/metrico/gigapipe:latestConfigure Gigapipe using ENV Settings - requires ClickHouse for data storage
📦 Docker Compose
Full-Stack deployment including Gigapipe, ClickHouse and Grafana
View full example →⚙️ Key Configuration Variables (all optional except CLICKHOUSE_SERVER)
Gigapipe has no config files — configure via environment variables.
| Variable | Default | Description |
|---|---|---|
CLICKHOUSE_SERVER | localhost | ClickHouse server address *required |
CLICKHOUSE_PORT | 9000 | ClickHouse server port (binary) |
CLICKHOUSE_DB | qryn | ClickHouse database name |
CLICKHOUSE_AUTH | default: | Authentication (user:password) |
PORT | 3100 | HTTP API port |
QRYN_LOGIN | — | Basic HTTP username |
QRYN_PASSWORD | — | Basic HTTP password |
Step 2: Configure Observability Agents
⭐ Use any Loki, InfluxDB, Elastic, Prometheus or OpenTelemetry compatible Agent or Client
📊 Logs
Use any Loki, InfluxDB, Elastic compatible Agent or Client
📈 Metrics
Use any Prometheus, InfluxDB, OpenTelemetry compatible Agent or Client
🔍 Traces
Use any OpenTelemetry, Tempo or Zipkin compatible Agent or Client
🔥 Profiles
Use any Pyroscope SDK compatible Agent or Client
🔭 OpenTelemetry Collector
Use Gigapipe with OpenTelemetry Collector Agents
The gigapipe-otel-collector is designed to store observability data (Traces, Logs, Metrics, Profiles) from multiple vendors/platforms into ClickHouse using gigapipe fingerprinting and table formats transparently accessible through gigapipe APIs via LogQL, PromQL, Tempo and Pyroscope queries.
Step 3: Visualize Your Data
Gigapipe is fully compatible with Grafana and Perses — explore your data your way
Drop-in compatible with Grafana Loki, Prometheus, Tempo and Pyroscope datasources. Any Grafana Cloud tutorial works as-is.
⭐ Explore Logs using the native Loki Datasource
⭐ No Grafana? Every Gigapipe setup includes access to the native Gigapipe View UI — a lightweight, fast alternative for exploring Logs, Metrics and Traces.
📦 qryn-view on GitHubPerses is an open-source dashboard tool for Metrics and Traces that is fully drop-in compatible with Gigapipe — a great Grafana alternative backed by the Cloud Native Computing Foundation.
Step 4: You're Done! 🎉
Any tutorial or example from Grafana Cloud should work as-is in Gigapipe.
🎉 AGPLv3 Licensed
Gigapipe is licensed under the AGPLv3 License and available on Github