Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

39 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

HyperbyteDB is a time-series database written in Rust that provides InfluxDB v1 API compatibility, uses embedded ClickHouse (chDB) for queries and native MergeTree storage, and RocksDB for WAL/metadata. It supports master-master clustering for replication.

Key Features

  • InfluxDB v1 API compatible — Line protocol and HTTP API for Telegraf, Grafana, and other 1.x clients
  • TimeseriesQL — Time-series analytics query language
  • Columnar MergeTree storage — Per-measurement ReplacingMergeTree
  • WAL — Durable write-ahead log and metadata
  • Active-active clustering — Raft for schema consensus; every node accepts writes with async or sync-quorum replication
  • Built-in observability — Prometheus metrics and structured logs

Quick Start

Docker

docker pull ghcr.io/hyperbyte-cloud/hyperbytedb:latest

docker run -d \
  --name hyperbytedb \
  -p 8086:8086 \
  ghcr.io/hyperbyte-cloud/hyperbytedb:latest

Docker Compose (quick start)

docker compose -f deploy/compose/docker-compose.getting-started.yml up -d

This starts HyperbyteDB, Telegraf, Prometheus, Loki, and Grafana — pre-configured with host-metrics collection and dashboards.

Open Grafana at http://localhost:3000 (admin / admin) and check the HyperbyteDB Cluster and Machine Monitoring dashboards.

For a Compose stack that builds from source (contributors), see the Development Setup guide.

CLI client

hyperbytedb-cli provides an interactive TimeseriesQL shell, batch queries, and write/import over the HTTP API (InfluxDB v1 influx-compatible). See the CLI guide.

curl -fsSL https://raw.githubusercontent.com/hyperbyte-cloud/hyperbytedb/main/scripts/install-cli.sh | sudo bash

Installs the latest Linux release from GitHub Releases to /usr/local/bin. See the CLI guide for version pinning and user-local installs.

Documentation

Doc Description
Documentation home Documentation home and navigation
User Guide Install, configure, and operate
Configuration Config file and environment variables
Administration Backups, metrics, cluster ops
System Architecture Internal design overview
Clustering Deep Dive Replication, Raft, sync APIs
Replication Design Replication wire format and evolution
Developer Guide Building and contributing
Code Review Rubric PR review checklist and test ownership

About

HyperbyteDB is a time-series database written in Rust that provides InfluxDB v1 API compatibility, uses embedded ClickHouse (chDB) for queries and native MergeTree storage, and RocksDB for WAL/metadata. It supports master-master clustering for replication.

Topics

Resources

Security policy

Stars

10 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages