gitwtfhub

wtf is litestream?

tailscale/litestream — explained in plain English

Analysis updated 2026-07-25 · repo last pushed 2022-10-05

2Audience · developerComplexity · 3/5DormantLicenseSetup · moderate

TL;DR

Litestream continuously backs up your SQLite database by streaming changes to local files or cloud storage, so you don't lose data if a server crashes.

Mindmap

mindmap
  root((repo))
    What it does
      Continuous SQLite backup
      Streams only changes
      Runs in background
    Storage targets
      Local file backup
      Amazon S3 cloud
    Tech stack
      Go
      SQLite API
      Amazon S3
    Use cases
      Small app backups
      Edge deployments
      Side project safety net
    Audience
      Developers
      Side project owners
      Edge deploy users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Back up a SQLite database for a small web app or blog to prevent data loss on server failure.

REASON 2

Stream SQLite changes to Amazon S3 for durable off-site backup without a full database server.

REASON 3

Add replication safety to edge deployments where a traditional database is overkill.

What's in the stack?

GoSQLiteAmazon S3

How it stacks up

tailscale/litestream0-bingwu-0/live-interpreter010zx00x1/faresnipe
Stars222
LanguagePythonPython
Last pushed2022-10-05
MaintenanceDormant
Setup difficultymoderatemoderateeasy
Complexity3/52/52/5
Audiencedevelopergeneralgeneral

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires configuring a storage destination such as an Amazon S3 bucket with credentials before replication can run.

Use freely for any purpose, including commercial use, as long as you include the copyright notice.

Wtf does this do

Litestream is a tool that keeps your SQLite databases safe by automatically copying their changes to another location, like a backup file or Amazon S3 storage. SQLite is a popular, lightweight database that stores everything in a single file, but it doesn't have built-in replication. This project solves that problem by running quietly in the background, continuously saving your data so you don't lose it if something goes wrong. The tool works by monitoring your database and sending incremental updates, only the changes, not the whole database, either to another file on your machine or to cloud storage. It talks to SQLite through its official API, which means it won't corrupt your database while it's running. This approach is much faster and more efficient than doing full database backups on a schedule. This would appeal to developers running small applications, side projects, or edge deployments where a full database server feels like overkill but you still need reliable backups. For example, if you have a blog or a small SaaS app using SQLite and you want to make sure a server crash doesn't wipe out your users' data, this gives you that safety net without the complexity of setting up a traditional database replication system. The project is currently in beta. While it was originally closed to outside code contributions to reduce maintainer burnout, it now accepts bug fixes from the community, though new features are still not being accepted. The maintainer emphasizes that testing, feedback, and documentation are the most valuable forms of contribution.

Yoink these prompts

Prompt 1
How do I configure Litestream to continuously back up my SQLite database to Amazon S3?
Prompt 2
Set up Litestream to replicate a SQLite file to a local backup path and explain how recovery works after a crash.
Prompt 3
What's the simplest Litestream config for a single SQLite database on a small VPS, and how do I monitor that backups are running?

Frequently asked questions

wtf is litestream?

Litestream continuously backs up your SQLite database by streaming changes to local files or cloud storage, so you don't lose data if a server crashes.

Is litestream actively maintained?

Dormant — no commits in 2+ years (last push 2022-10-05).

What license does litestream use?

Use freely for any purpose, including commercial use, as long as you include the copyright notice.

How hard is litestream to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is litestream for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.