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.9-linux-amd64.tar.gz
|
| Linux ARM64 | litestream-vfs-v0.5.9-linux-arm64.tar.gz
|
| macOS Intel | litestream-vfs-v0.5.9-darwin-amd64.tar.gz
|
| macOS Apple Silicon | litestream-vfs-v0.5.9-darwin-arm64.tar.gz
|
Changelog
- 3a67f13 Add cross-version upgrade integration test (v0.3.x → v0.5.x) (#1137)
- 5b8a7d1 add Hetzner S3 signed-payload preset (#1026)
- 249f46d ci: enable automatic Homebrew tap updates on release (#1117)
- 09c2313 docs(agent): update replica-client-developer with v0.3.x and ResumableReader (#1112)
- 84a5d31 docs(agents): add IPC, leasing, library API, and retention references (#1107)
- 5e6a91c docs(architecture): add IPC server, distributed leasing, and library API (#1108)
- c835786 docs(claude): add debug-ipc command and provider compatibility reference (#1116)
- 23f8b5a docs(command): add IPC, retention, and v0.3.x issues to fix-common-issues (#1113)
- 6bcedb2 docs(command): add debug-ipc command for IPC socket troubleshooting (#1114)
- b2980bd docs(patterns): add ResumableReader, retention bypass, and conditional write patterns (#1109)
- 0f80b4d docs(provider-compat): update R2 detection defaults and version compat (#1111)
- d4130d5 docs(replica-client): add v0.3.x restore interface and ResumableReader note (#1110)
- d87d657 feat(docker): add hardened scratch-based image variant (#1126)
- 020da8e feat(ipc): add sync command for on-demand database replication (#1120)
- 0df6829 feat(restore): add -f follow mode for continuous restore (#1102)
- aa81289 feat(s3): add LITESTREAM_S3_ENDPOINT env var for URL-based restore (#1145)
- 70bb846 feat(s3): add Supabase S3-compatible provider auto-detection (#1135)
- 61a2def feat(sync): add replicated_txid to sync response (#1141)
- fe7fb7a feat(vfs): add PRAGMA litestream_write_enabled for runtime write control (#1009)
- 95253c4 fix(ci): authenticate GitHub API call in NATS test setup (#1144)
- 155507b fix(db): count sync errors when db.init() fails (#1129)
- 48ecd53 fix(db): detect WAL changes via shm mxFrame (#1087)
- 634c74f fix(restore): expose -follow-interval CLI flag for follow mode (#1139)
- 47e9010 fix(vfs): persist hydration file across connection restarts (#1125)
- 0ad19ff test(ci): add smoke tests for hardened scratch Docker image (#1132)
- a404d7b test(metrics): add coverage for all Prometheus metrics (#1127)