Getting Started
This section guides you through setting up and using Cobble for different use cases — from a single-machine embedded store to a distributed cluster with snapshot-following reads and parallel scans.
Start with Basic Concepts for an overview of the key components, then Configuration to understand how Cobble organizes storage, and finally choose the deployment model that fits your application:
| Guide | When to use |
|---|---|
| Basic Concepts | Core components — Db, Coordinator, Reader, Scanner, snapshots |
| Configuration | Every deployment starts here — volumes, tuning, and storage layout |
| Single-Machine Embedded DB | Simple embedded key-value store on a single machine |
| Distributed DB | Multiple writer shards coordinated by a global snapshot system |
| Reader & Distributed Scan | Serve snapshot-following reads or run parallel analytical scans across shards |
| Remote Compaction | Offload background compaction to dedicated worker nodes |
| Structured DB | Type-safe row-oriented wrappers for all of the above |