mirror of https://github.com/benbjohnson/litestream.git synced 2026-01-25 05:06:30 +00:00

Go to file

Cory LaNou bc02dc734b refactor(ipc): remove /status endpoint, add lastSyncAt to /list

Per review feedback on PR #1015, this removes the /status endpoint
and socket mode from the status command to avoid the confusing
behavior where only one command requires the -socket flag.

Instead of /status, the /list endpoint now includes lastSyncAt
for each database, providing the sync timing information without
needing a separate endpoint.

Changes:
- Remove GET /status endpoint from server
- Remove -socket flag and runWithSocket from status command
- Add LastSyncAt field to DatabaseSummary in /list response
- Update tests accordingly

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

2026-01-19 14:31:15 -06:00

_examples/library

fix(examples): use DSN params for PRAGMAs in library examples (#938 )

2025-12-30 08:19:49 -06:00

.claude

feat(vfs): support creating new databases in write mode (#972 )

2026-01-08 08:47:42 -07:00

.github

feat(vfs): add Dockerfile.vfs for VFS-enabled images (#970 )

2026-01-13 09:21:52 -06:00

abs

feat(abs): add SAS token authentication for Azure Blob Storage (#983 )

2026-01-11 10:54:48 -06:00

cmd

refactor(ipc): remove /status endpoint, add lastSyncAt to /list

2026-01-19 14:31:15 -06:00

docs

feat(abs): add SAS token authentication for Azure Blob Storage (#983 )

2026-01-11 10:54:48 -06:00

etc

feat(replicate): add IPC control commands for dynamic start/stop (#1010 )

2026-01-17 10:32:41 -06:00

file

fix(file): clean up .ltx.tmp files on all error paths (#991 )

2026-01-12 09:20:01 -06:00

grafana

Add Grafana dashboard for monitoring Litestream metrics (#737 )

2025-09-08 14:45:23 -05:00

Refactor replica URL parsing (#884 )

2025-12-10 16:10:55 -07:00

internal

feat(abs): add SAS token authentication for Azure Blob Storage (#983 )

2026-01-11 10:54:48 -06:00

mock

Refactor replica URL parsing (#884 )

2025-12-10 16:10:55 -07:00

nats

Refactor replica URL parsing (#884 )

2025-12-10 16:10:55 -07:00

oss

fix(s3,oss): remove HeadObject calls that caused timestamp restore hang (#932 )

2025-12-30 08:19:22 -06:00

fix(performance): reduce idle CPU usage from ~0.7% to ~0.1% (#993 )

2026-01-13 09:22:35 -06:00

scripts

test: migrate bash integration and soak tests to Go infrastructure (#799 )

2025-11-03 11:17:21 -06:00

sftp

Refactor replica URL parsing (#884 )

2025-12-10 16:10:55 -07:00

src

feat(vfs): add Dockerfile.vfs for VFS-enabled images (#970 )

2026-01-13 09:21:52 -06:00

testdata

feat: Add litestream-test harness for comprehensive database testing (#748 )

2025-09-25 16:51:26 -05:00

tests

fix(performance): reduce idle CPU usage from ~0.7% to ~0.1% (#993 )

2026-01-13 09:22:35 -06:00

webdav

Refactor replica URL parsing (#884 )

2025-12-10 16:10:55 -07:00

.aiexclude

docs: add AI agent documentation with principle-based approach (#787 )

2025-11-03 10:56:30 -06:00

.cursorrules

docs: add AI agent documentation with principle-based approach (#787 )

2025-11-03 10:56:30 -06:00

.gitignore

chore: ignore local Ralph Wiggum loop planning files (#984 )

2026-01-11 10:54:16 -06:00

.goreleaser.yml

feat(release): add automated VFS builds for releases (#864 )

2025-12-01 13:23:30 -07:00

.markdownlint.json

feat: Add litestream-test harness for comprehensive database testing (#748 )

2025-09-25 16:51:26 -05:00

.pre-commit-config.yaml

Fix pre-commit config typo and run goimports

2025-07-31 17:08:59 -05:00

AGENTS.md

docs: restructure LLM documentation for better PR quality (#961 )

2026-01-06 13:34:01 -06:00

AI_PR_GUIDE.md

docs: restructure LLM documentation for better PR quality (#961 )

2026-01-06 13:34:01 -06:00

CLAUDE.md

docs: restructure LLM documentation for better PR quality (#961 )

2026-01-06 13:34:01 -06:00

compaction_level.go

feat(vfs): add VFS compaction support via shared Compactor type (#979 )

2026-01-09 16:07:50 -06:00

compactor_test.go

feat(vfs): add VFS compaction support via shared Compactor type (#979 )

2026-01-09 16:07:50 -06:00

compactor.go

feat(vfs): add VFS compaction support via shared Compactor type (#979 )

2026-01-09 16:07:50 -06:00

CONTRIBUTING.md

docs: restructure LLM documentation for better PR quality (#961 )

2026-01-06 13:34:01 -06:00

db_internal_test.go

fix(sync): add exponential backoff for error resilience (#931 )

2026-01-06 13:30:48 -06:00

db_shutdown_test.go

feat(db): add shutdown sync retry for rate limiting resilience (#904 )

2025-12-29 15:05:32 -06:00

db_test.go

fix: improve error recovery for missing/corrupted LTX files (#963 )

2026-01-09 16:13:52 -06:00

db.go

feat(replicate): add IPC control commands for dynamic start/stop (#1010 )

2026-01-17 10:32:41 -06:00

docker-compose.test.yml

fix(s3): improve S3-compatible provider compatibility (#899 )

2025-12-16 13:32:22 -07:00

Dockerfile

feat(vfs): add Dockerfile.vfs for VFS-enabled images (#970 )

2026-01-13 09:21:52 -06:00

GEMINI.md

docs: restructure LLM documentation for better PR quality (#961 )

2026-01-06 13:34:01 -06:00

go.mod

fix(s3): disable checksum on Uploader for S3-compatible providers (#956 )

2026-01-06 10:41:00 -06:00

go.sum

fix(s3): disable checksum on Uploader for S3-compatible providers (#956 )

2026-01-06 10:41:00 -06:00

heartbeat_test.go

feat(heartbeat): add notification hooks for health check services (#926 )

2026-01-06 11:18:23 -06:00

heartbeat.go

feat(heartbeat): add notification hooks for health check services (#926 )

2026-01-06 11:18:23 -06:00

LICENSE

Add pre-commit linting, test all PRs (#541 )

2023-12-15 21:49:29 +02:00

litestream_test.go

fix: improve error recovery for missing/corrupted LTX files (#963 )

2026-01-09 16:13:52 -06:00

litestream.go

fix: improve error recovery for missing/corrupted LTX files (#963 )

2026-01-09 16:13:52 -06:00

llms.txt

docs: restructure LLM documentation for better PR quality (#961 )

2026-01-06 13:34:01 -06:00

Makefile

fix(vfs): resolve make vfs build failures (#874 )

2025-12-08 14:37:59 -06:00

README.md

Remove test badge from README

2025-12-10 16:57:01 -07:00

replica_client_test.go

fix: improve error recovery for missing/corrupted LTX files (#963 )

2026-01-09 16:13:52 -06:00

replica_client.go

Refactor replica URL parsing (#884 )

2025-12-10 16:10:55 -07:00

replica_test.go

fix(restore): validate LTX file size before restore (#858 )

2025-12-04 11:51:12 -06:00

replica_url_test.go

test: improve test coverage for edge case bug prevention (#952 ) (#954 )

2026-01-09 12:22:26 -06:00

replica_url.go

fix(s3): default to https:// for cloud endpoints (UX improvement) (#949 )

2026-01-06 11:58:00 -06:00

replica.go

fix: improve error recovery for missing/corrupted LTX files (#963 )

2026-01-09 16:13:52 -06:00

SECURITY.md

Improve contribution documentation with templates and guidelines (#699 )

2025-08-13 11:03:05 -05:00

server_test.go

refactor(ipc): remove /status endpoint, add lastSyncAt to /list

2026-01-19 14:31:15 -06:00

server.go

refactor(ipc): remove /status endpoint, add lastSyncAt to /list

2026-01-19 14:31:15 -06:00

store_compaction_remote_test.go

Refactor replica URL parsing (#884 )

2025-12-10 16:10:55 -07:00

store_test.go

fix(test): resolve flaky TestStore_CompactDB/L1 timing issue (#920 )

2025-12-18 17:40:33 -06:00

store.go

feat(replicate): add IPC control commands for dynamic start/stop (#1010 )

2026-01-17 10:32:41 -06:00

vfs_compaction_test.go

feat(vfs): add VFS compaction support via shared Compactor type (#979 )

2026-01-09 16:07:50 -06:00

vfs_test.go

feat(vfs): add background database hydration for improved read performance (#978 )

2026-01-09 14:17:32 -07:00

vfs_write_test.go

fix(vfs): fail fast when write buffer initialization fails (#974 )

2026-01-08 13:50:44 -06:00

vfs.go

feat(vfs): add hydration env vars to loadable extension (#1000 )

2026-01-14 08:18:05 -07:00

wal_reader_test.go

feat: Add litestream-test harness for comprehensive database testing (#748 )

2025-09-25 16:51:26 -05:00

wal_reader.go

fix(wal): filter stale pages when database shrinks (#881 )

2025-12-09 11:45:52 -06:00

README.md

Litestream

Litestream is a standalone disaster recovery tool for SQLite. It runs as a background process and safely replicates changes incrementally to another file or S3. Litestream only communicates with SQLite through the SQLite API so it will not corrupt your database.

If you need support or have ideas for improving Litestream, please join the Litestream Slack or visit the GitHub Discussions. Please visit the Litestream web site for installation instructions and documentation.

If you find this project interesting, please consider starring the project on GitHub.

Contributing

We welcome bug reports, fixes, and patches! Please see our Contributing Guide for details on how to contribute.

Acknowledgements

I want to give special thanks to individuals who invest much of their time and energy into the project to help make it better:

Thanks to Cory LaNou for giving early feedback and testing when Litestream was still pre-release.
Thanks to Michael Lynch for digging into issues and contributing to the documentation.
Thanks to Kurt Mackey for feedback and testing.
Thanks to Sam Weston for figuring out how to run Litestream on Kubernetes and writing up the docs for it.
Thanks to Rafael & Jungle Boogie for helping to get OpenBSD release builds working.
Thanks to Simon Gottschlag, Marin,Victor Björklund, Jonathan Beri Yuri, Nathan Probst, Yann Coleu, and Nicholas Grilly for frequent feedback, testing, & support.

Huge thanks to fly.io for their support and for contributing credits for testing and development!