Skip to main content

Quickstart

Standalone (Fastest)​

docker run -d --name thermocline -p 27017:27017 -v thermocline-data:/data stronglyai/thermocline

Connect with any MongoDB driver:

mongosh "mongodb://localhost:27017"

Smoke Validation​

use thermocline_demo
db.samples.insertMany([{k: 1, v: "hot"}, {k: 2, v: "cold"}])
db.samples.find().sort({k: 1})

Docker Compose (with Cold Storage)​

For automatic hot-to-cold tiering with local MinIO:

curl -O https://raw.githubusercontent.com/strongly-ai/thermocline/main/docker-compose.quickstart.yml
docker compose -f docker-compose.quickstart.yml up -d
mongosh "mongodb://localhost:27017"

Build from Source​

git clone https://github.com/strongly-ai/thermocline.git
cd thermocline
make dev-up
./scripts/dev/wait-for-services.sh
mongosh "mongodb://127.0.0.1:27017"

Stop​

# Standalone
docker stop thermocline && docker rm thermocline

# Docker Compose
docker compose -f docker-compose.quickstart.yml down

# From source
make dev-down

Local Endpoints​

  • Gateway wire endpoint: 127.0.0.1:27017
  • Gateway metrics: 127.0.0.1:9100/metrics
  • MinIO Console (compose only): 127.0.0.1:9001