System Requirements
Hardware
| Component | Minimum | Recommended |
|---|---|---|
| CPU | 4 cores | 8+ cores (more cores = more parallel workers) |
| RAM | 4 GB | 16+ GB (buffer pool + JIT compilation) |
| Storage | SSD | NVMe SSD (O_DIRECT I/O) |
| OS | Linux kernel 5.10+ | Linux kernel 6.x |
Performance Notes
- CPU cores: ScramDB pins one worker thread per core. More cores = linear scaling for parallel queries.
- Memory: Buffer pool size is the primary memory consumer. Set
SCRAMDB_MEMORY_LIMITto ~70% of available RAM. - Storage: NVMe SSDs recommended for Tundra columnar storage. ScramDB uses O_DIRECT I/O to bypass the OS page cache.
- JIT: JIT compilation uses ~50-100MB additional memory for the JIT context. This is shared across all queries.
Supported Platforms
| Platform | Status |
|---|---|
| Linux x86-64 | ✅ Fully supported |
| Linux ARM64 | ✅ Supported |
| macOS (Apple Silicon) | ⚠️ Development only |
| Windows | ❌ Not supported (use Docker/WSL2) |