// troubleshooting guide · syncthing
Syncthing 2.0 Database Migration Stuck
- Status
- Workaround available
- platforms:
- Windows, macOS, Linux, NAS, Docker
- updated:
- November 16, 2026
- reports:
- 5
- Method
- how we research
RUNBOOK · syncthing/database-migration-stuck3 FIXES
// quick answer
Syncthing 2.0 converts its index from LevelDB to SQLite on first start, which can take many hours on large setups. Let it run uninterrupted on a current 2.x release; if it fails with a malformed database, delete the index and let Syncthing rebuild it.
Most likely fix: Let it finish uninterrupted
How to fix it
// try these in order, the most common fix is first
FIX 1Let it finish uninterrupted
- 01Check the log for migration progress instead of restarting
- 02Disable health checks or auto-restart on your NAS app while it migrates
Did this fix it?FIX 2Upgrade to the latest 2.x
- 01Install the current 2.1.x release; maintainers said 2.0.3 already fixed migrations stalling after interruption
Did this fix it?FIX 3Rebuild the database
- 01Stop Syncthing
- 02Move the index database folder out of the Syncthing config directory (keep config.xml and keys)
- 03Start Syncthing; it rescans your folders and rebuilds the index from disk and peers
Did this fix it?
Symptoms
After upgrading to 2.x the GUI doesn't come up or shows migration progress for hours or days, NAS apps restart Syncthing mid-migration, or logs show 'database disk image is malformed'.
Why it happens
- C-01Very large indexes (hundreds of thousands of files) and slow disks
- C-02Database not fitting in RAM on small NAS devices
- C-03Container platforms (e.g. TrueNAS) killing the process during migration
- C-04Bugs in early 2.0.x builds, fixed in later point releases
// this guide also covers
- syncthing 2.0 migration stuck
- syncthing database migration slow
- syncthing database disk image is malformed
Still not working?
If Syncthing keeps failing, you're not alone. See every Syncthing problem users report or the alternatives people switch to.
Have an app idea? Our small team builds any software: web and mobile apps, games, desktop, AI tools. Price agreed together.
Talk to usThe same problem in other apps
Nextcloud Desktop Client Sync Slow (Nextcloud)
Dropbox Not Syncing (Dropbox)
Seafile Client Not Syncing (Seafile)
pCloud Not Syncing or Sync Stuck (pCloud)