Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time



Go Report Card License Docker Image Version Docker Image Size

SquirrelDB is a scalable and highly available timeseries database (TSDB) compatible with Prometheus remote storage. Timeseries are stored in Cassandra to provide scalability and availability.


  • Time Series Database with Prometheus Long Term Storage
  • Support pre-aggregation of data for faster read
  • Rely on Cassandra, well known and reliable NoSQL database
  • Support single node and cluster architectures
  • Expose PromQL, remote read and write Prometheus endpoints

High Availability

SquirrelDB allows both availability and scalability:

  • The long term storage availability and scalability is done by a Cassandra cluster by using a replication level > 1 (3 is recommended).
  • The short term storage (by default last 15 minutes) is stored in-memory by default and can be configured to be stored in Redis. A Redis cluster will provide availability and scalability of short term storage.
  • When short term storage is provided by Redis, SquirrelDB instance are stateless, scaling them is just adding more of them behind a load-balancer (like nginx).

Check out examples/squirreldb-ha for a highly available setup.


You can run SquirrelDB easily with Cassandra, Prometheus, Grafana and Node Exporter using the provided docker-compose:

docker-compose up -d

Then go to the Grafana dashboard at http://localhost:3000/d/83ceCuenk/, and log in with the user "admin" and the password "password". You may need to wait a few minutes to see the graphs, because Cassandra starts slowly.

Single node installation


Cassandra must be running before starting SquirrelDB. If you don't have Cassandra, you can run it with Docker:

# The network is needed only if you run SquirrelDB with Docker.
docker network create squirreldb

docker run -d --name squirreldb-cassandra -p \
    --net squirreldb -e MAX_HEAP_SIZE=128M -e HEAP_NEWSIZE=24M cassandra


You can run SquirrelDB as a binary using the latest Github release for your platform at


You can use docker to run SquirrelDB:

docker run -d --name squirreldb -p \
    --net squirreldb -e SQUIRRELDB_CASSANDRA_ADDRESSES=squirreldb-cassandra:9042 \


The file squirreldb.conf contains all available configuration options. This file must be placed in the same directory as the SquirrelDB binary.

All configuration options can be overriden by environment variables. The environment variable is

  • Prefixed by SQUIRRELDB_
  • All letters are converted to uppercase
  • Each yaml indentation is converted to an underscore

For example, cassandra.addresses becomes SQUIRRELDB_CASSANDRA_ADDRESSES.