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.3-beta1-linux-amd64.tar.gz
|
| Linux ARM64 | litestream-vfs-v0.5.3-beta1-linux-arm64.tar.gz
|
| macOS Intel | litestream-vfs-v0.5.3-beta1-darwin-amd64.tar.gz
|
| macOS Apple Silicon | litestream-vfs-v0.5.3-beta1-darwin-arm64.tar.gz
|
Changelog
- d0fd303 Don't sleep on context cancellation errors on shutdown (#814)
- e40c8a5 Ensure S3 uploads use unsigned payload (#812)
- e4e82ee Fix LTX write error message (#855)
- cff9506 Fix minor bugs in VFS (#823)
- 71ba7d2 Remove deprecated Makefile dist targets after GoReleaser migration (#797)
- 2ee408b SSH host key check (#609)
- 0a0e7e4 Store new pages in pending index during read transactions (#828)
- 7c3a44a VFS: Implement page cache (#838)
- be474af VFS: Poll for L0 & L1 files (#837)
- cf0eb02 chore(deps): switch from sqlite3vfs fork to upstream (#867)
- bec72f4 feat(checkpoint): add configurable WAL truncate threshold (#824)
- a82ccf1 feat(ci): add stale issue workflow to auto-manage inactive issues (#816)
- 2484e25 feat(config): support SQLite connection string prefixes in db path (#859)
- 130fa20 feat(oss): add native Alibaba Cloud OSS storage backend (#862)
- f99e629 feat(release): add automated VFS builds for releases (#864)
- 0a2f0e1 feat(s3): add S3 access point ARN URL support (#819)
- 53f896e feat(s3): add automatic Tigris endpoint detection (#845)
- 88632bb feat(s3): add configurable payload signing and Content-MD5 headers for S3-compatible providers (#842)
- ab4941a feat(vfs): add PRAGMA-based time travel for querying historical database states (#850)
- f5b166a feat(vfs): add observability PRAGMAs and relative time parsing (#856)
- 5e598f1 feat: Add custom S3 endpoint support via URL query parameters (#731)
- 9be9408 feat: add WebDAV replica backend support (#813)
- e87000c feat: add directory replication support for multi-tenant databases (#738)
- fa1e0ea feat: implement comprehensive global replica defaults (#746)
- 8415802 feat: implement time-based L0 retention for VFS support (#821)
- fa826e9 fix(ci): use jq for NATS CLI version extraction in GitHub Actions (#834)
- 9c4c904 fix(deps): remove unused age encryption dependency (#870)
- a5f673d fix(deps): update dependencies to resolve security vulnerabilities (#860)
- 0c03074 fix(docker): update Go version to 1.25 in Dockerfile (#872)
- 5cb6fd6 fix(gs): translate size=0 to length=-1 in OpenLTXFile for full object reads (#807)
- 3f3e7ea fix(release): rename VFS extension to litestream.so (#865)
- f500ac2 fix(restore): skip overlapping files within same compaction level (#857)
- d206e45 fix(restore): validate LTX file size before restore (#858)
- d5f0071 fix(test): resolve flaky TestStore_Integration SQLITE_BUSY failures (#815)
- a494508 fix(vfs): critical bug fixes and comprehensive testing infrastructure (#835)
- 9e4db3b fix(vfs): resolve make vfs build failures (#874)
- 9bdaf9f fix: add Content-MD5 header for S3 DeleteObjects to support OCI compatibility (#808)
- 8c67540 fix: add support for part-size and concurrency in S3 replica config (#796)
- 48dc960 fix: busy timeout config (#830)
- 6c5f569 fix: update GoReleaser configurations (#755)