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.10-linux-amd64.tar.gz
|
| Linux ARM64 | litestream-vfs-v0.5.10-linux-arm64.tar.gz
|
| macOS Intel | litestream-vfs-v0.5.10-darwin-amd64.tar.gz
|
| macOS Apple Silicon | litestream-vfs-v0.5.10-darwin-arm64.tar.gz
|
Install via package managers:
pip install litestream-vfs # Python
npm install litestream-vfs # Node.js
gem install litestream-vfs # RubyChangelog
- 5531fab Revert "fix(db): add warning log and test for WAL change detection (#946)" (#1187)
- ab55194 Revert "fix(db): detect WAL changes via shm mxFrame (#1087)" (#1185)
- 40af24a ci(pr-metrics): add PR build metrics workflow (#1158)
- f404f2f ci(pr-metrics): replace collapsible sections with plain headers (#1184)
- ae88b16 feat(logging): add .With() system identifiers to all top-level loggers (#1191)
- 2d5f628 feat(restore): add crash recovery txid file for follow mode (#1136)
- f6ba05f feat(restore): add post-restore integrity validation (#1170)
- 1345ed7 feat(vfs): distribute VFS extension via PyPI, npm, and RubyGems (#1148)
- 1f423d7 fix(ci): publish latest-scratch Docker tag (#1180)
- 166cbe3 fix(deps): bump Go to 1.25.0/toolchain 1.25.8 for security patches (#1188)
- d514bc7 fix(logging): use db.Logger and s.Logger instead of default slog in Store (#1181)
- 6843423 fix(replica): promote LTX upload log to Info level with size field (#1182)
- e8b2ada fix(security): upgrade Go toolchain to 1.24.13 (#1162)
- 0b3facd fix(test): resolve 4 failing tests on main (#1156)
- 038b296 fix(vfs): coordinate expectedTXID across pooled write connections (#1140)
- bd2c6e6 perf(db): cache Pos() result to avoid repeated disk reads (#1192)
- 80b1b3b test(profile): add idle CPU profiling test (#1190)