User Guide
This guide covers deploying, configuring, and operating HyperbyteDB. You do not need to read the source code.
Reading order
| Step | Page | What you will do |
| 1 | Installation | Run HyperbyteDB with Docker, Compose, kind, or the Kubernetes operator |
| 2 | Configuration | Set config.toml and environment variables |
| 3 | Basic operations | Create a database, write line protocol, run TimeseriesQL |
| 3b | CLI (hyperbytedb-cli) | Interactive shell, batch queries, write/import from the terminal |
| 4 | Authentication | Optional: require credentials on /write and /query |
| 5 | Advanced features | Clustering, continuous queries, TLS, tracing |
| 6 | Common workflows | Migrate from InfluxDB 1.x, wire Telegraf and Grafana |
| 7 | Administration | Metrics, logs, traces, backups, cluster operations |
| 8 | Troubleshooting | Fix startup, query, and cluster issues |
| 9 | API reference | HTTP endpoints and TimeseriesQL compatibility |
Prerequisites
| Requirement | Details |
| Platforms | Linux x86_64 or aarch64 for pre-built images and tarballs; macOS supported for source builds |
| Runtime | Docker, or Rust + libchdb for source builds |
| Network | Port 8086 by default for the HTTP API |