Litestream Files

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)

:::bash
brew tap benbjohnson/litestream
brew install litestream

Debian/Ubuntu

Download the .deb file for your architecture and install:

:::bash
sudo dpkg -i litestream-*.deb

RPM-based systems

Download the .rpm file for your architecture and install:

:::bash
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:

Install via package managers:

:::bash
pip install litestream-vfs    # Python
npm install litestream-vfs    # Node.js
gem install litestream-vfs    # Ruby

Changelog

• [102d2d] Log the resolved repica type when unknown (#1466)
• [923d7c] chore(deps): bump Go toolchain to 1.25.13 (#1434)
• [3b468c] chore(deps): bump Go toolchain to 1.25.14 (#1476)
• [69e918] config: reject duplicate dbs[].path at load (#1452)
• [ec542d] docs(readme): document internal lock table (#1438)
• [534d8f] docs(retention): explain snapshot floor (#1437)
• [25ac74] feat(vfs): thread-safe config registry for per-database VFS configuration (#1157)
• [0c961f] fix(ci): always report test summary (#1474)
• [63225f] fix(config): accept l0-retention: 0 as disabled (#1425)
• [62297c] fix(deps): remove release-blocking SQLite WAL-reset corruption exposure (#1436)
• [8ff85b] fix(logging): downgrade replica sync messages from INFO to DEBUG (#1207)
• [0cce01] fix(replica): return an error for a truncated page index (#1431)
• [4250ef] fix(restore): correctly restore v3 wal segments that exceed 4GB (#1442)
• [97d2df] fix(restore): retry through provider throttle responses (#1433)
• [a89a7c] fix(restore): sort v3 WAL offsets safely (#1448)
• [ccd326] fix(s3): allow disabling accept encoding signing (#1439)
• [ad10a1] fix(s3): tune Tigris multipart upload defaults (#1482)