// troubleshooting guide · syncthing
Syncthing Not Syncing
- Status
- Workaround available
- platforms:
- Windows, macOS, Linux, Android
- updated:
- November 16, 2026
- reports:
- 5
- Method
- how we research
RUNBOOK · syncthing/not-syncing6 FIXES
// quick answer
When Syncthing shows devices connected but files don't move, the folder is usually not shared/accepted on both sides, blocked by ignore patterns or permissions, or paused by an error. Check the folder state and the logs, then rescan.
Most likely fix: Confirm the folder is shared both ways
How to fix it
// try these in order, the most common fix is first
FIX 1Confirm the folder is shared both ways
- 01Open the web GUI (http://127.0.0.1:8384) on both devices
- 02Check that the same Folder ID appears on both, and that each device is ticked under Edit > Sharing
- 03Accept any pending 'wants to share folder' notification
Did this fix it?FIX 2Check folder types
- 01Edit the folder > Advanced > Folder Type
- 02Use Send & Receive on both sides unless you deliberately want one-way sync
Did this fix it?FIX 3Review ignore patterns
- 01Edit the folder > Ignore Patterns on each device
- 02Remove or narrow patterns that match the missing files
- 03Click Rescan
Did this fix it?FIX 4Fix permissions
- 01Find which user runs Syncthing (service user, Docker PUID/PGID)
- 02Give that user read/write access to the folder and its parents
- 03Check the log for 'permission denied' after a rescan
Did this fix it?FIX 5Read the failed items and logs
- 01Click the folder and open 'Failed Items' or 'Out of Sync Items'
- 02Open Actions > Logs and search for the file name
- 03Fix the reported error (path too long, name conflict, permission)
Did this fix it?FIX 6Restart and update
- 01Actions > Restart on both devices
- 02Update to the latest release (2.1.x as of late 2026); many stuck-sync bugs were fixed in point releases
Did this fix it?
Symptoms
Files added on one device never appear on the other, the folder stays 'Up to Date' on one side and 'Syncing' or 'Out of Sync' on the other, or devices show 'Disconnected'.
Why it happens
- C-01Folder shared from one device but never accepted on the other, or folder IDs don't match
- C-02Folder type is Send Only on the receiving side or Receive Only on the sending side
- C-03.stignore patterns on either device excluding the files
- C-04The account running Syncthing lacks read/write permission on the target folder
- C-05Case-mismatched paths between Windows/macOS and Linux (foo/bar vs foo/Bar)
- C-06One device offline or the folder paused
// this guide also covers
- syncthing not syncing
- syncthing not working
- syncthing connected but not syncing
- why does syncthing not sync files
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)
Other Syncthing errors
- Syncthing Stuck on Out of Sync Items
- Syncthing Folder Marker Missing Error
- Syncthing Sync-Conflict Files Keep Appearing
- Syncthing Slow Sync Speed
- Syncthing Web GUI Not Loading (127.0.0.1:8384)
- Syncthing Android Not Syncing in Background
- Syncthing on iPhone Not Syncing
- Syncthing Failed to Start Filesystem Watcher