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.6-linux-amd64.tar.gz
|
| Linux ARM64 | litestream-vfs-v0.5.6-linux-arm64.tar.gz
|
| macOS Intel | litestream-vfs-v0.5.6-darwin-amd64.tar.gz
|
| macOS Apple Silicon | litestream-vfs-v0.5.6-darwin-arm64.tar.gz
|
Changelog
- 3480067 docs(examples): add library usage examples (#921)
- 5f6be88 feat(ci): add Cloudflare R2 integration tests (#917)
- fc1c254 feat(cli): add status command for replication monitoring (#962)
- 2d38fa4 feat(db): add shutdown sync retry for rate limiting resilience (#904)
- 62b25c1 feat(heartbeat): add notification hooks for health check services (#926)
- 36b9804 feat(replicate): add -once, -force-snapshot, and -enforce-retention flags (#929)
- 1b034be feat(replicate): add -restore-if-db-not-exists flag (#928)
- 9eab2a3 feat(s3): add LITESTREAM_S3_DEBUG env var for AWS SDK debug logging (#925)
- 92fc139 feat(s3): add server-side encryption support (SSE-C and SSE-KMS) (#902)
- 40dae8f feat(vfs): add write support with periodic sync to remote (#953)
- 9be0eb1 feat(vfs): support creating new databases in write mode (#972)
- 9d26487 fix(db): add warning log and test for WAL change detection (#946)
- 0ba567d fix(db): suppress double-rollback error in releaseReadLock (#935)
- e8653d7 fix(examples): use DSN params for PRAGMAs in library examples (#938)
- 2b055b1 fix(logging): add context to db initialization timeout warning (#960)
- 9c39382 fix(s3): add ResponseChecksumValidation for S3-compatible providers (#950)
- a7d773e fix(s3): default to https:// for cloud endpoints (UX improvement) (#949)
- 0edc3ec fix(s3): disable aws-chunked encoding for all S3-compatible providers (#919)
- a3a21c9 fix(s3): disable checksum on Uploader for S3-compatible providers (#956)
- 0a441d0 fix(s3): enable automatic ARN endpoint resolution for Access Points (#924)
- 253ff99 fix(s3,oss): remove HeadObject calls that caused timestamp restore hang (#932)
- d24abaf fix(sync): add exponential backoff for error resilience (#931)
- e1d5aad fix(test): resolve flaky TestStore_CompactDB/L1 timing issue (#920)
- 7a38f8b fix(vfs): fail fast when write buffer initialization fails (#974)
- 34215a4 fix: move wal_autocheckpoint PRAGMA to DSN parameters (#939)
- 271dd54 fix: prevent excessive snapshots after checkpoint truncation (#944)
- 186525e test(s3): use actual defaults in integration tests (#915)