Documentation

bakelite keeps a continuous copy of your SQLite database that you can restore to any moment you've captured — on local disk or any S3-compatible bucket. Every commit's copied as it happens, so what's backed up is your latest state, not last night's snapshot.

Point it at one database or every database on the box; it watches each one's WAL and ships changes as they commit. Unix-only for now (macOS, Linux).

Day to day you'll really only use two commands: one to run the daemon, one to restore. There's more in the box if you want it — at-rest encryption, a verify --deep that does a full restore drill, doctor pre-flight checks, multi-destination fan-out, a Prometheus /metrics endpoint — but none of it's required to get a safe backup.

bakelite is young: 0.1.0, and I've only run it on my own machines so far. Project status spells out what's well-tested and what to check before you trust it with your data. New here? Install & deploy gets you running, and How it works is the design.

• How it works
  What bakelite does under the hood, and why it stays consistent and safe against data loss.
• Correctness
  How bakelite checks that its restores are correct: a torture oracle drives a marked workload under faults and crashes, and grades every restore.
• Project status
  Where bakelite is on the maturity curve, what's well-tested, and how to validate it before you trust it with production data.
• Install & deploy
  Install via Homebrew on macOS, or the apt repo / one-line script / container on Linux, then run under launchd or systemd.
• Recipes
  Curated starter configs for the common scenarios — and the bakelite init wizard that fills them in.
• Configuration
  The TOML config: defaults, per-database overrides, and backends.
• Backends
  Supported storage backends and the cross-backend compatibility matrix.
• CLI reference
  The bakelite subcommands and their flags.
• Operations & disaster recovery
  Run bakelite in production: enable the daemon and the health timers, alert on the right thresholds, and recover a lost database with a boring checklist.
• Restore
  Point-in-time restore: targets, integrity checks, and safe swaps.
• Versioning & compatibility
  How bakelite versions itself across upgrades, and what happens when an older binary meets a newer replica.
• Changelog
  What changed in each bakelite release.