// 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
Share

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

  1. FIX 1Let it finish uninterrupted

    1. 01Check the log for migration progress instead of restarting
    2. 02Disable health checks or auto-restart on your NAS app while it migrates
    Did this fix it?
  2. FIX 2Upgrade to the latest 2.x

    1. 01Install the current 2.1.x release; maintainers said 2.0.3 already fixed migrations stalling after interruption
    Did this fix it?
  3. FIX 3Rebuild the database

    1. 01Stop Syncthing
    2. 02Move the index database folder out of the Syncthing config directory (keep config.xml and keys)
    3. 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 us

Watch Syncthing Get an email when its price changes, it has an outage, or we publish a new fix. No spam.

Fixed it? Share this guide

The same problem in other apps

All sync failures guides →

Other Syncthing errors

All 12 Syncthing errors and fixes →