# Install opentsdb with Homebrew, Nix

Scalable, distributed Time Series Database. Version 2.4.1 via Homebrew; verified 2026-06-22.

## Install

```sh
sudo av install brew:opentsdb
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install opentsdb
```

  Evidence: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#opentsdb
```

  Evidence: nixpkgs package indexes: pkgs/by-name/op/opentsdb/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

## Package facts

- **Package key:** brew:opentsdb
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/opentsdb>
- **Version:** 2.4.1
- **Source summary:** Scalable, distributed Time Series Database
- **Homepage:** <http://opentsdb.net/>
- **Repository:** <https://github.com/OpenTSDB/opentsdb>
- **Upstream docs:** <https://opentsdb.net/docs/build/html/index.html>
- **License:** LGPL-2.1-or-later
- **Source archive:** <https://github.com/OpenTSDB/opentsdb/archive/refs/tags/v2.4.1.tar.gz>
- **Last updated:** 2026-06-22T14:05:45-07:00
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- start-tsdb.sh (cli)
- tsdb (cli)
- start-tsdb.sh (alias)
- tsdb (alias)

## Dependencies

- gnuplot
- hbase
- lzo
- openjdk@11

## Build dependencies

- autoconf
- automake
- openjdk@8
- python@3.13

## Install behavior

- Post-install hook: defined
- Service: declared
- Bottle: available on arm64_linux, sonoma, ventura, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 2.4.1
- Package-manager updated: 2026-06-22
- Local data: ok
- Upstream repository: https://github.com/OpenTSDB/opentsdb
- Upstream latest detected: v2.4.1 (current)
## Project history and usage

OpenTSDB is a distributed time-series database built on HBase for storing, indexing, querying, and graphing high-volume metrics without downsampling away raw granularity. It ships a Time Series Daemon, command-line tools, HTTP and telnet-style APIs, and an HBase schema tuned for metric names, timestamps, and tags.

### Project history

OpenTSDB was originally designed and implemented at StumbleUpon by Benoît Sigoure, with early design input from Berk D. Demir. It grew out of the operational need to collect metrics from networks, operating systems, applications, and services at a scale where older fixed-size or single-node monitoring stores were not sufficient.

The project chose HBase because it could distribute writes and scans across a cluster while keeping raw metric points for long periods. Public talks and documentation from the early 2010s emphasized billion-point-per-day ingestion, large numbers of time series, and avoiding the loss of precision common in round-robin databases.

### Adoption history

OpenTSDB’s adoption followed the rise of large Hadoop/HBase installations and high-cardinality infrastructure monitoring. Its contributor list includes companies such as StumbleUpon, Yahoo, Box, Arista Networks, Betfair, Limelight Networks, and others, showing use beyond the original StumbleUpon deployment.

Its protocol and data model also outlived some deployments of the original server. Cloud vendors and monitoring tools documented OpenTSDB-compatible ingestion or comparison points because the metric-plus-tags model became a familiar shape for time-series telemetry systems.

### How it is used

Operators run one or more independent TSD processes in front of HBase or Google Bigtable-compatible storage. Collectors such as tcollector, collectd, StatsD bridges, or custom scripts send datapoints, while users query and graph by metric, timestamp range, and tags through the HTTP API or built-in UI.

For package users, the interesting pieces are the `tsdb` command, `start-tsdb.sh`, the configuration search path, and the dependency on a correctly prepared HBase schema. Installing the package is only the first step; a usable OpenTSDB deployment depends on distributed storage, collectors, and retention choices.

### Why package nerds care

OpenTSDB is a reminder that some packages are operational systems disguised as CLIs. The formula installs Java code and scripts, but the real dependency is an HBase-backed monitoring architecture with schema, collectors, ports, and dashboards.

### Timeline

- 2010: OpenTSDB was written at StumbleUpon to handle large-scale service metrics.
- 2012: public talks described StumbleUpon deployments adding over one billion datapoints per day.
- 2014: OpenTSDB 2.0-era material described the project as a distributed, scalable time-series database with broader community involvement.
- 2020s: OpenTSDB 2.4 documentation remained the main reference for the classic HBase-backed architecture.

### Related projects

- Related projects include HBase, Google Bigtable, tcollector, collectd, StatsD, Grafana, Prometheus, InfluxDB, Graphite, and cloud services that expose OpenTSDB-compatible APIs.

### Sources

- <https://dbdb.io/db/opentsdb>
- <https://github.com/OpenTSDB/opentsdb>
- <https://github.com/OpenTSDB/opentsdb/blob/master/AUTHORS>
- <https://opentsdb.net/>
- <https://opentsdb.net/faq.html>
- <https://opentsdb.net/misc/opentsdb-hbasecon.pdf>
- <https://opentsdb.net/overview.html>
- <https://opentsdb.net/schema.html>


## Security Notes

broad file, network, media, or database tool signal. formula declares a Homebrew service.

- **Geiger risk:** orange / medium
- broad file, network, media, or database tool signal
- formula declares a Homebrew service


## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: ./opentsdb.conf, /etc/opentsdb.conf, /etc/opentsdb/opentsdb.conf, /opt/opentsdb/opentsdb.conf
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** opentsdb
- **Version Scheme:** 0
- **Revision:** 0
- **Requirements:** arch
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** yes
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** stable

## Other Package-Manager Records

- Nix - opentsdb: normalized package name match | nixpkgs package indexes: pkgs/by-name/op/opentsdb/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1


## Related links

- [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [gnuplot](https://www.automicvault.com/pkg/brew/gnuplot/) - Runtime dependency declared by Homebrew.
- [hbase](https://www.automicvault.com/pkg/brew/hbase/) - Runtime dependency declared by Homebrew.
- [openjdk@11](https://www.automicvault.com/pkg/brew/openjdk-11/) - Runtime dependency declared by Homebrew.
- [autoconf](https://www.automicvault.com/pkg/brew/autoconf/) - Build dependency declared by Homebrew.
- [automake](https://www.automicvault.com/pkg/brew/automake/) - Build dependency declared by Homebrew.
- [openjdk@8](https://www.automicvault.com/pkg/brew/openjdk-8/) - Build dependency declared by Homebrew.
- [python@3.13](https://www.automicvault.com/pkg/brew/python-3-13/) - Build dependency declared by Homebrew.
- [influxdb](https://www.automicvault.com/pkg/brew/influxdb/) - Shares av.db curated category or tags: cli, data, database, time-series, time-series-database.
- [victoriametrics](https://www.automicvault.com/pkg/brew/victoriametrics/) - Shares av.db curated category or tags: cli, data, monitoring, time-series-database.
- [check_postgres](https://www.automicvault.com/pkg/brew/check-postgres/) - Shares av.db curated category or tags: cli, data, database, monitoring.
- [influxdb-cli](https://www.automicvault.com/pkg/brew/influxdb-cli/) - Shares av.db curated category or tags: cli, data, database, time-series.
- [questdb](https://www.automicvault.com/pkg/brew/questdb/) - Shares av.db curated category or tags: cli, data, database, time-series.
- [telegraf](https://www.automicvault.com/pkg/brew/telegraf/) - Shares av.db curated category or tags: cli, data, monitoring, time-series.
- [traildb](https://www.automicvault.com/pkg/brew/traildb/) - Shares av.db curated category or tags: cli, data, database, time-series.
- [apache-geode](https://www.automicvault.com/pkg/brew/apache-geode/) - Shares av.db curated category or tags: cli, data, database.

## Combined YAML source

View the package source record on GitHub. [combined/opentsdb.yml](https://github.com/automic-vault/db/blob/main/combined/opentsdb.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
