- Author
- Alex Chan, Tailscale
- Published
- 12 August 2026
- Kind
- Company engineering blog post, incident postmortem
- Original
- tailscale.com/blog/sqlite-wal-reset-bug
- Subject
- Databases and storage
- Themes
- How things break
What it is
Alex Chan writes for Tailscale's blog. The post explains an outage-prone period and apologizes for it. It also tells how the team helped expose the WAL-reset bug.
What it says
- Tailscale suffered 19 separate database corruption incidents over six months before the bug was fixed.
- The team found no common trigger, so it relied on passive telemetry in live production.
- A transaction log pipeline showed committed writes that later vanished without any error.
- SQLite developers named a rare checkpoint and write race the WAL-Reset bug.
- The post says SQLite developers estimate the bug lasted at least 16 years. It was rare enough that tests had to force it.
- Tailscale hit the bug more often because it runs checkpoints manually and aggressively.
- The first fix release, 3.52.0, caused false corruption alarms and was withdrawn for 3.51.3.
What evidence it gives
The evidence is Tailscale's own incident history and logs. A custom warning fired in production, two months after deployment. The post says four months then passed without a database incident. It shows no controlled reproduction by Tailscale.
Interests and limits
Tailscale is a vendor writing about its own outages. The cause is called likely, not proven in every incident. Its manual checkpointing is unusual, so the odds may not apply to typical SQLite users. The post says Tailscale funded the shim that helped isolate the bug.
Connections
These links are this wiki's own reading, not claims the sources make.
- Hunting a 16-year-old SQLite bug with TLA+: is dqlite affected?. These describe one bug from two sides. Tailscale needed six months and 19 incidents to find it through telemetry. The model checker reached a counterexample in 20 states, once people knew what to model. Finding and confirming turn out to be different jobs.