Platform Support
⚠️ Windows Notice: Windows binaries are provided for convenience but Windows is NOT an officially supported platform. Use at your own risk. Community contributions for Windows improvements are welcome.
✅ Supported Platforms: Linux (amd64, arm64, armv6, armv7), macOS (amd64, arm64)
Installation
Homebrew (macOS and Linux)
brew tap benbjohnson/litestream
brew install litestreamDebian/Ubuntu
Download the .deb file for your architecture and install:
sudo dpkg -i litestream-*.debRPM-based systems
Download the .rpm file for your architecture and install:
sudo rpm -i litestream-*.rpmBinary installation
Download the appropriate archive for your platform, extract, and move to your PATH.
VFS Extension (Experimental)
SQLite loadable extensions for read-only access to Litestream replicas are available for supported platforms:
| Platform | File |
|---|---|
| Linux x86_64 | litestream-vfs-v0.5.7-linux-amd64.tar.gz
|
| Linux ARM64 | litestream-vfs-v0.5.7-linux-arm64.tar.gz
|
| macOS Intel | litestream-vfs-v0.5.7-darwin-amd64.tar.gz
|
| macOS Apple Silicon | litestream-vfs-v0.5.7-darwin-arm64.tar.gz
|
Changelog
- 92f9883 Add debug logging to S3 fileIterator.Next() (#1068)
- c77ecef feat(abs): add SAS token authentication for Azure Blob Storage (#983)
- bd57a0f feat(replicate): add --log-level CLI flag for runtime debugging (#986)
- ed28f2e feat(replicate): add IPC control commands for dynamic start/stop (#1010)
- 2a03354 feat(s3): implement ReplicaClientV3 for v0.3.x backup restore (#1075)
- c582db1 feat(s3): improve observability for S3 operations and L0 retention (#996)
- ecb34a0 feat(vfs): add Dockerfile.vfs for VFS-enabled images (#970)
- 4a3bff1 feat(vfs): add LITESTREAM_LOG_FILE env var for log redirection (#1024)
- bb911d9 feat(vfs): add PRAGMA litestream_hydration_progress (#1003)
- 91f5e37 feat(vfs): add VFS compaction support via shared Compactor type (#979)
- e45a292 feat(vfs): add background database hydration for improved read performance (#978)
- c9ee814 feat(vfs): add hydration env vars to loadable extension (#1000)
- b474098 feat: Add optional post-compaction consistency verification (#1029)
- 931fe09 feat: add $PID environment variable for config expansion (#1070)
- f418bd0 feat: add /txid IPC endpoint (#1071)
- 9c56809 feat: add Replica.ValidateLevel and Store.Validate (#1066)
- 3a2d1c8 feat: add debug logging for S3 requests (#1067)
- f5d6128 feat: add pprof endpoints to IPC server (#1069)
- caee8e1 feat: add v0.3.x RestoreV3 method for backup restore (Phase 4) (#1054)
- bde5c44 feat: add v0.3.x backup types and path helpers (Phase 1) (#1045)
- 133abe7 feat: add v0.3.x file open with LZ4 decompression (Phase 3) (#1053)
- 1593a60 feat: add v0.3.x snapshot/WAL listing for file backend (Phase 2) (#1048)
- 28a0ab6 feat: integrate v0.3.x restore into Replica.Restore() (Phase 5) (#1074)
- a2a160a fix(cmd): ensure structured logging for all commands (#985)
- 593dff5 fix(db): use logical WAL offset for checkpoint decisions (#999)
- 5420136 fix(deps): update modernc.org/sqlite to v1.44.3 (#1033)
- b5cba15 fix(docs): remove outdated Slack and GitHub Discussions references (#1062)
- 33639d4 fix(file): clean up .ltx.tmp files on all error paths (#991)
- 6a82fc0 fix(iterator): surface blob listing errors for better diagnostics (#1017)
- bfe8d33 fix(mcp): fix broken tools and add status/reset/version tools (#1049)
- a9af19b fix(performance): reduce idle CPU usage from ~0.7% to ~0.1% (#993)
- 559aa47 fix(restore): check all compaction levels in TimeBounds() (#1063)
- 08e03b4 fix(restore): update help text to use -txid flag and fix example (#1040)
- 6d2d87f fix(s3): add diagnostic logging for LTX file deletion (#981)
- 59b5e2d fix(test): correct snapshot directory path and expand CI test coverage (#1023)
- b65e4fe fix: improve error recovery for missing/corrupted LTX files (#963)
- f3b62ff fix: mark lz4/v4 as direct dependency (#1060)
- cb2d885 fix: reduce noise from 'page size not initialized' error (#1036)
- 87d1f0d test(vfs): add rollback verification tests for writable VFS (#1005)