// troubleshooting guide · syncthing

Syncthing Not Syncing

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

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

  1. FIX 1Confirm the folder is shared both ways

    1. 01Open the web GUI (http://127.0.0.1:8384) on both devices
    2. 02Check that the same Folder ID appears on both, and that each device is ticked under Edit > Sharing
    3. 03Accept any pending 'wants to share folder' notification
    Did this fix it?
  2. FIX 2Check folder types

    1. 01Edit the folder > Advanced > Folder Type
    2. 02Use Send & Receive on both sides unless you deliberately want one-way sync
    Did this fix it?
  3. FIX 3Review ignore patterns

    1. 01Edit the folder > Ignore Patterns on each device
    2. 02Remove or narrow patterns that match the missing files
    3. 03Click Rescan
    Did this fix it?
  4. FIX 4Fix permissions

    1. 01Find which user runs Syncthing (service user, Docker PUID/PGID)
    2. 02Give that user read/write access to the folder and its parents
    3. 03Check the log for 'permission denied' after a rescan
    Did this fix it?
  5. FIX 5Read the failed items and logs

    1. 01Click the folder and open 'Failed Items' or 'Out of Sync Items'
    2. 02Open Actions > Logs and search for the file name
    3. 03Fix the reported error (path too long, name conflict, permission)
    Did this fix it?
  6. FIX 6Restart and update

    1. 01Actions > Restart on both devices
    2. 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 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 →