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.3-linux-amd64.tar.gz | | Linux ARM64 | litestream-vfs-v0.5.3-linux-arm64.tar.gz | | macOS Intel | litestream-vfs-v0.5.3-darwin-amd64.tar.gz | | macOS Apple Silicon | litestream-vfs-v0.5.3-darwin-arm64.tar.gz |

Changelog

• d0fd30347b0d56ff8cf8290ce8e5254707d6444a Don't sleep on context cancellation errors on shutdown (#814)
• e40c8a5985ac5223bef4bff124b1a912630809fe Ensure S3 uploads use unsigned payload (#812)
• e4e82ee750d22d8b390d4c6a7bfa852397294974 Fix LTX write error message (#855)
• cff9506a5100172a2f9b0cdc79aadf48d9115983 Fix minor bugs in VFS (#823)
• 70c70c79070cea4d3f5d39c3253238fe5195fe16 Lower log level for slog in VFS (#887)
• 8efcdd7e59bb3f7ce30cba7fc408a9e1155e10be Refactor replica URL parsing (#884)
• 71ba7d2b5e83fdf7d7a926aae872802e5963eb39 Remove deprecated Makefile dist targets after GoReleaser migration (#797)
• a8f6d9d4f59a59189b33a554617232ccb19454ee Remove test badge from README
• 2ee408b66bb78ca3ff52fc867ca66f3c8b154e6b SSH host key check (#609)
• 0a0e7e4663408813acd617a029e7136d75e52247 Store new pages in pending index during read transactions (#828)
• 7c3a44a87a32f5651a3b19067d3360e9b5abdd8d VFS: Implement page cache (#838)
• be474af9694e052903a715e8115a07cd7f4d8df8 VFS: Poll for L0 & L1 files (#837)
• cf0eb02c08de4ff938717dc781879cfdc5f7ee36 chore(deps): switch from sqlite3vfs fork to upstream (#867)
• bec72f47ca18da62492be0e92ba44c65986e7b2e feat(checkpoint): add configurable WAL truncate threshold (#824)
• a82ccf1648b8e5c3929fcf2e1b2cdc611f121d87 feat(ci): add stale issue workflow to auto-manage inactive issues (#816)
• 2484e258edd42106a094b71f1eb29a0844ac3be1 feat(config): support SQLite connection string prefixes in db path (#859)
• 130fa20432df72709da4d04cb0f8d103a4232ad1 feat(oss): add native Alibaba Cloud OSS storage backend (#862)
• f99e629625d9cb046279a6a4a5a156eaced85190 feat(release): add automated VFS builds for releases (#864)
• 0a2f0e199e26c791292787f0c8eb89d433921513 feat(s3): add S3 access point ARN URL support (#819)
• 53f896e19506460f44d3b6d4c5f83f9545ced6ca feat(s3): add automatic Tigris endpoint detection (#845)
• 88632bbbc5123ac6f2e52cc90656a8b00e267bfc feat(s3): add configurable payload signing and Content-MD5 headers for S3-compatible providers (#842)
• ab4941a66f499fb7f8795953ef72c2f41a248aac feat(vfs): add PRAGMA-based time travel for querying historical database states (#850)
• f5b166ab2172849536bed16e03f9cec59070314d feat(vfs): add observability PRAGMAs and relative time parsing (#856)
• 5e598f17f6840541ad1da342ef41ecf0b6bc4b57 feat: Add custom S3 endpoint support via URL query parameters (#731)
• 9be94080f12982968061c6018ca99a70a5913bea feat: add WebDAV replica backend support (#813)
• e87000c3ae81ba9d135999429d78329dde16a7cf feat: add directory replication support for multi-tenant databases (#738)
• fa1e0eaa7d2490e4396ad4d1803cac99a41b3aa2 feat: implement comprehensive global replica defaults (#746)