Litestream v0.5.0 is Here

Summary

Litestream v0.5.0 updates the SQLite backup and restore tool with faster operation and efficient point-in-time recovery (PITR). It replaces WAL segment generations with LTX files, an interchange format for ordered page ranges that supports compaction and monotonically incrementing transaction IDs. Hierarchical compaction combines changes across 30-second, five-minute, and hourly levels, allowing restoration to any point in time using only about a dozen files on average and performance limited by I/O throughput. The release keeps old v0.3.x WAL files intact and preserves configuration compatibility, but permits only one replica destination per database and renames litestream wal to litestream ltx. It also adds per-page compression and indexing, removes CGO through modernc.org/sqlite, supports NATS JetStream replicas, updates cloud-storage clients, and previews a VFS for read replicas that can fetch pages from S3 while hydration continues.

Takeaways

1. 1

   LTX compaction creates 30-second, five-minute, and hourly levels, so restoration to a point in time typically uses only about a dozen files.

2. 2

   The upgrade preserves old v0.3.x WAL files and keeps the configuration format backwards compatible, but a database may now have only one replica destination.

3. 3

   LTX files now use per-page compression and an end-of-file index, enabling page-granular access within large files and supporting future point-in-time queries without downloading the whole database.