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 litestream

Debian/Ubuntu

Download the .deb file for your architecture and install:

sudo dpkg -i litestream-*.deb

RPM-based systems

Download the .rpm file for your architecture and install:

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.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

• 3480067f4b7577b2a5295c5d1a4d8acb1796b16e docs(examples): add library usage examples (#921)
• 5f6be88c4bcf834f9147cf573474678eb311d6e4 feat(ci): add Cloudflare R2 integration tests (#917)
• fc1c254922d50b46445b54ed6a1ea10a9581a106 feat(cli): add status command for replication monitoring (#962)
• 2d38fa490b82d3cc6b9182b0f154128caedc9781 feat(db): add shutdown sync retry for rate limiting resilience (#904)
• 62b25c13dc165f4beeb95c34a37d2f205b9d7964 feat(heartbeat): add notification hooks for health check services (#926)
• 36b980474faa29e987985b0900f7100b0e099bc0 feat(replicate): add -once, -force-snapshot, and -enforce-retention flags (#929)
• 1b034bea2e61373a44fa972b0547deb17832a69f feat(replicate): add -restore-if-db-not-exists flag (#928)
• 9eab2a339572d47f7b478abf6f9c4bf04bb2b38e feat(s3): add LITESTREAM_S3_DEBUG env var for AWS SDK debug logging (#925)
• 92fc139923d2b13909ba8b0e5df8b63d45a91648 feat(s3): add server-side encryption support (SSE-C and SSE-KMS) (#902)
• 40dae8f0895b569a2f9e2d6273cb70acc854de0a feat(vfs): add write support with periodic sync to remote (#953)
• 9be0eb116dac9dead798a1074c02d75ec0ca09ee feat(vfs): support creating new databases in write mode (#972)
• 9d2648700ef60c740332250ea46927d59254ccdb fix(db): add warning log and test for WAL change detection (#946)
• 0ba567d083af0321adad411adb6f7e6b7d60bfe7 fix(db): suppress double-rollback error in releaseReadLock (#935)
• e8653d70b63971b0f5abbc6940f868f9d1245084 fix(examples): use DSN params for PRAGMAs in library examples (#938)
• 2b055b1c85f79595375c9e263fb38811550fed3f fix(logging): add context to db initialization timeout warning (#960)
• 9c39382a3cdac419f9aec92f5864299deac03fd7 fix(s3): add ResponseChecksumValidation for S3-compatible providers (#950)
• a7d773e7a4478d1a0e2b6df1d8cfa5f8f7f4e7c5 fix(s3): default to https:// for cloud endpoints (UX improvement) (#949)
• 0edc3ecbd25e9c781d973c304f6bbe0e5361cf30 fix(s3): disable aws-chunked encoding for all S3-compatible providers (#919)
• a3a21c9e26207f5b218eee0a775e8f6675c3e505 fix(s3): disable checksum on Uploader for S3-compatible providers (#956)
• 0a441d06fe1bf3386c118380015b07b7aae92553 fix(s3): enable automatic ARN endpoint resolution for Access Points (#924)
• 253ff992b928a6fcf0067e01c20b6cc66a36f8fa fix(s3,oss): remove HeadObject calls that caused timestamp restore hang (#932)
• d24abaf707678b54120dc96bfa7ba08d24ece7f5 fix(sync): add exponential backoff for error resilience (#931)
• e1d5aad75bc67735732b54a252d98685c502288b fix(test): resolve flaky TestStore_CompactDB/L1 timing issue (#920)
• 7a38f8b5d9a94044bbb65ea88db63cba8ef5b2e2 fix(vfs): fail fast when write buffer initialization fails (#974)
• 34215a41a528515d4b282628a0f0cb023a4ceffc fix: move wal_autocheckpoint PRAGMA to DSN parameters (#939)