Introduction
Thermocline is a MongoDB-wire-compatible document database with three execution modes:
- Hot: native storage-engine execution
- Cold: query-engine execution over object storage data
- Federated hot/cold: coordinator merge execution
For v1.0, the source of truth is the implementation in the Thermocline repository:
- Runtime architecture:
README.md,docs/ARCHITECTURE.md - Compatibility matrix:
docs/COMPATIBILITY.md - Canonical command surface:
services/gateway/src/proxy/handler/mod.rsandservices/gateway/src/proxy/handler/handshake.rs
Component Model
| Component | Language | Role |
|---|---|---|
| Gateway | Rust | MongoDB wire protocol, auth, command dispatch |
| Coordinator | Go | Routing/orchestration for hot, cold, federated |
| Storage Engine | Rust | Hot tier writes/reads, indexes, MVCC, aggregation authority |
| Query Engine | Rust | Cold tier execution over object storage datasets |
| Controller | Go | Archival/lifecycle and backup/restore control plane |
| Operator | Go | Kubernetes operations |
| Standalone | Go | Local all-in-one process manager |
What This Documentation Guarantees
This site is maintained as implementation-backed documentation for v1.0:
- No claims are made without code or tests behind them.
- Tier support statements follow the compatibility matrix.
- Feature docs call out partial support and routed behavior where applicable.
Start with: