# nanotdb

> NanoTDB is a self-hosted, open-source TSDB that runs as a single binary with built-in dashboard, editor, Explore view, and offline CLI for Raspberry Pi and edge devices.

- **Category:** Databases & storage
- **Licence:** MIT
- **Latest version:** v1.4.0
- **Open source:** oss
- **Languages:** Go, JavaScript
- **Platforms:** Linux, Build from Source, Systemd
- **Tags:** Dashboard, Databases, Raspberry Pi, Iot, Mqtt, Homelab, Observability, Single Binary, Time-Series, Golang, Tsdb, Edge, Raspberrypi, Nanocli, Rollups

## Description

NanoTDB packages a time-series database, browser dashboard, visual editor, ad-hoc explorer, and offline command-line tool into one Go binary. It ingests metrics via line protocol, supports range and aggregate queries, handles downsampling through built-in rollups, and retains data by deleting partition files. The storage engine uses append-only, S2-compressed pages with a write-ahead log that replays on restart after crashes or power loss — a design tuned for SD-card longevity on Raspberry Pi and similar edge hardware. An optional sidecar collector named drip can push host-level metrics (CPU, memory, disk, network, load, temperature) into the database. The HTTP API matches the VictoriaMetrics wire format for instant and range queries. All configuration lives in TOML files (engine.toml for global settings, manifest.toml per database). No external database, cache, or message broker is required.

## Links

- [Homepage](https://github.com/aymanhs/nanotdb)
- [Releases](https://github.com/aymanhs/nanotdb/releases)
- [GitHub Repository](https://github.com/aymanhs/nanotdb)

---
Source: https://selfhost.directory/project/nanotdb