selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

GitHub
nanotdb logo

Self-host nanotdb

v1.4.0

Single-binary TSDB with built-in dashboard for edge devices

BetaOpen SourceMIT
Updated5 months ago
LanguageGo
Setup difficultyEasy
MobileResponsive
Stars
141
Port
8428 (HTTP server (dashboard, API, ingest))
Install with Build from Source
Mobile-friendly dashboard showing CPU and memory widgetsWide desktop dashboard layout for denser widget placementExplore view with metric picker and live chartIn-browser dashboard editor for groups, widgets, and series

What is nanotdb?

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.

Should you self-host nanotdb?

nanotdb scores 44/100 on selfhost.directory (how scoring works) and ranks #6 of 7 in Databases & storage. It has 141 GitHub stars.

It shipped 6 stable releases in the past year. The latest, v1.4.0, came out on 28 May 2026. New versions land roughly every 1 days.

Setup is easy: most people get it running in one sitting. It is MIT-licensed and written mostly in Go.

Its closest alternative on selfhost.directory is pgvector (76/100, 23 516 stars). It scores higher overall, so compare the two before you pick. See nanotdb vs pgvector side by side.

Features

  • Aggregate queries
  • Built-in Dashboard
  • Crash Recovery
  • Dashboard editor
  • Embedded engine
  • Explore view
  • Line protocol ingest
  • MQTT ingest
  • Offline CLI (nanocli)
  • Prometheus-compatible import
  • Retention
  • Rollups
  • VictoriaMetrics-compatible query API

nanotdb README

How to install nanotdb

Install nanotdb with Build from Source

Requirements: Go 1.20+, Git, Linux/macOS/Windows (WSL2 on Windows)

git clone cd nanotdb

go build -o nanotdb ./cmd/nanotdb go build -o nanocli ./cmd/nanocli go build -o drip ./cmd/drip # optional collector

Requires Go 1.20+

nanotdb releases & version history

More in Databases & storage

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…