// troubleshooting guide · syncthing

Syncthing Stuck on Out of Sync Items

Status
Workaround available
platforms:
Windows, macOS, Linux, Android
updated:
November 16, 2026
reports:
5
Method
how we research
Share

RUNBOOK · syncthing/out-of-sync-items5 FIXES

// quick answer

A folder stuck at a partial percentage or with out-of-sync items that never clear usually needs a restart of both devices, a check of the listed items, and as a last resort removing and re-adding the folder.

Most likely fix: Inspect the out-of-sync list

How to fix it

// try these in order, the most common fix is first

  1. FIX 1Inspect the out-of-sync list

    1. 01Click the folder > Out of Sync Items
    2. 02Note which files are stuck and check the log for their errors
    3. 03If the log says no connected device has the required version, bring the device that had it online
    Did this fix it?
  2. FIX 2Restart Syncthing fully on both devices

    1. 01Use Actions > Restart (or restart the service/app, not just the browser tab)
    2. 02Users report a full process restart retriggered sync where a GUI reload did not
    Did this fix it?
  3. FIX 3Rescan and update

    1. 01Click Rescan on the folder on both sides
    2. 02Update both devices to the same current version
    Did this fix it?
  4. FIX 4Remove and re-add the folder

    1. 01Back up the folder first
    2. 02Remove the folder in the GUI on the stuck device (files on disk stay)
    3. 03Add it again with the same Folder ID and path; Syncthing re-indexes and merges
    Did this fix it?
  5. FIX 5Reset the index as a last resort

    1. 01Stop Syncthing
    2. 02Start it once with the --reset-deltas option (check syncthing --help for the exact syntax of your version) and let it reconnect
    3. 03Don't keep this flag permanently
    Did this fix it?

Symptoms

The GUI shows 'Out of Sync' or 'Syncing (99%)' indefinitely, the remote device lists items it still needs, or logs say 'no connected device has the required version of this file'.

Why it happens

  • C-01The only device that had the latest version of a file is offline
  • C-02Stale or inconsistent index data after crashes or upgrades
  • C-03A file that can't be written on the target (permissions, invalid name, path too long)
  • C-04Version-specific bugs fixed in later releases

// this guide also covers

  • syncthing out of sync items
  • syncthing stuck syncing
  • syncthing stuck at 99
  • syncthing out of sync not going away

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 →