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)
:::bash
brew tap benbjohnson/litestream
brew install litestream
Debian/Ubuntu
Download the .deb file for your architecture and install:
:::bash
sudo dpkg -i litestream-*.deb
RPM-based systems
Download the .rpm file for your architecture and install:
:::bash
sudo rpm -i litestream-*.rpm
Binary 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:
:::bash
pip install litestream-vfs # Python
npm install litestream-vfs # Node.js
gem install litestream-vfs # Ruby
Changelog
- [5531fa] Revert "fix(db): add warning log and test for WAL change detection (#946)" (#1187)
- [ab5519] Revert "fix(db): detect WAL changes via shm mxFrame (#1087)" (#1185)
- [40af24] ci(pr-metrics): add PR build metrics workflow (#1158)
- [f404f2] ci(pr-metrics): replace collapsible sections with plain headers (#1184)
- [ae88b1] feat(logging): add .With() system identifiers to all top-level loggers (#1191)
- [2d5f62] feat(restore): add crash recovery txid file for follow mode (#1136)
- [f6ba05] feat(restore): add post-restore integrity validation (#1170)
- [1345ed] feat(vfs): distribute VFS extension via PyPI, npm, and RubyGems (#1148)
- [1f423d] fix(ci): publish latest-scratch Docker tag (#1180)
- [166cbe] fix(deps): bump Go to 1.25.0/toolchain 1.25.8 for security patches (#1188)
- [d514bc] fix(logging): use db.Logger and s.Logger instead of default slog in Store (#1181)
- [684342] fix(replica): promote LTX upload log to Info level with size field (#1182)
- [e8b2ad] fix(security): upgrade Go toolchain to 1.24.13 (#1162)
- [0b3fac] fix(test): resolve 4 failing tests on main (#1156)
- [038b29] fix(vfs): coordinate expectedTXID across pooled write connections (#1140)
- [bd2c6e] perf(db): cache Pos() result to avoid repeated disk reads (#1192)
- [80b1b3] test(profile): add idle CPU profiling test (#1190)