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.12-linux-amd64.tar.gz
|
| Linux ARM64 | litestream-vfs-v0.5.12-linux-arm64.tar.gz
|
| macOS Intel | litestream-vfs-v0.5.12-darwin-amd64.tar.gz
|
| macOS Apple Silicon | litestream-vfs-v0.5.12-darwin-arm64.tar.gz
|
Install via package managers:
pip install litestream-vfs # Python
npm install litestream-vfs # Node.js
gem install litestream-vfs # RubyChangelog
- 817ebb0 docs(cli): add databases help examples (#1243)
- e266164 docs(cli): add info help examples (#1242)
- 265be76 docs(cli): add list help examples (#1241)
- 3a9df4b docs(cli): add register help examples (#1237)
- 739312f docs(cli): add start stop help examples (#1239)
- 5bd5ca3 docs(cli): add status help examples (#1246)
- 72d7533 docs(cli): add sync help examples (#1240)
- 7c63954 docs(cli): add unregister help examples (#1238)
- d932bc0 docs(cli): document json output schemas (#1250)
- 2e8c73a feat(cli): add databases json output (#1247)
- eeb3801 feat(cli): add ltx json output (#1248)
- 2d38d20 feat(cli): add register success payload (#1255)
- 8aa7945 feat(cli): add reset dry run (#1252)
- fbe1739 feat(cli): add restore dry run (#1251)
- 30c039f feat(cli): add restore json output (#1249)
- 64e8757 feat(cli): add start stop success payload (#1256)
- 19d6064 feat(cli): add status json output (#1245)
- a08a5e7 feat(cli): add sync success payload (#1257)
- fd4b600 feat(cli): add unregister dry run (#1253)
- dd59010 feat(cli): add unregister success payload (#1258)
- 552672f feat(cli): guard restore overwrites (#1254)
- 0de07a3 feat(db): expose sync diagnostics (#1287)
- 9cc2f2d fix(build): bump Go toolchain to 1.25.9 for stdlib vulns (#1235)
- 6ebcacc fix(cli): add try hints for required flags (#1236)
- dbcd1a0 fix(cli): clarify register idempotency (#1259)
- 8e9b907 fix(cli): clarify unregister idempotency (#1261)
- fc050c9 fix(cli): exit 0 for explicit help (#1233)
- 853cbf3 fix(cli): make start stop idempotent (#1260)
- 4784cc9 fix(cli): polish agent-facing errors (#1297)
- edc4328 fix(compactor): close pipe on upload failure (#1286)
- c32f63c fix(config): honor database snapshot settings (#1285)
- 4cb2d7c fix(deps): bump x/crypto and x/net to clear govulncheck (#1294)
- a590e05 fix(restore): check for wal segment gaps in v3 restore (#1230)
- c28a318 fix(restore): clean failed restore temp file (#1282)
- d4c00e3 fix(restore): retry initial ltx opens (#1284)
- a25a11f fix(security): bump Go 1.25.10 + deps to clear govulncheck (#1283)
- 6b8bb01 refactor(db): return sync results explicitly (#1224)
- 0c670da test(cli): drop static-string usage tests, restore captureStdout helper (#1295)