Syncthing Not Working? Common Errors & Fixes
The 12 Syncthing problems users hit most often, why they happen, and the fixes that actually work — collected from user reports, forums, and official support docs.
Syncthing Not Syncing
Workaround availableWindows, macOS, Linux, AndroidWhen 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.
Syncthing Stuck on Out of Sync Items
Workaround availableWindows, macOS, Linux, AndroidA 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.
Syncthing Folder Marker Missing Error
Workaround availableWindows, macOS, Linux, Android, Docker/NASSyncthing pauses a folder when its hidden .stfolder marker is missing, to avoid treating an unmounted drive as 'everything deleted'. Remount the drive, move the folder back, or recreate .stfolder.
Syncthing Sync-Conflict Files Keep Appearing
Workaround availableWindows, macOS, Linux, Android, iOS (third-party)Syncthing writes a .sync-conflict-<date>-<time>-<device> copy when a file changed on two devices before they synced. Ignore files that apps rewrite constantly and resolve the copies you have.
Syncthing Slow Sync Speed
Workaround availableWindows, macOS, Linux, AndroidSlow Syncthing transfers almost always mean the devices are connected through a relay instead of directly. Open the sync ports, set Windows networks to Private, or add device addresses manually.
Syncthing Web GUI Not Loading (127.0.0.1:8384)
Workaround availableWindows, macOS, Linux, NASIf http://127.0.0.1:8384 won't open, Syncthing is usually not running or is listening on a different address. Confirm the process, check the 'GUI and API listening on' log line, and change the GUI address for remote access.
Syncthing Android Not Syncing in Background
Workaround availableAndroidOn Android, sync stops when the OS kills the app for battery saving. Use the maintained Syncthing-Fork, exempt it from battery optimisation, and grant All files access for folders outside the app.
Syncthing on iPhone Not Syncing
OngoingiOS, iPadOSThere is no official Syncthing iOS app. Third-party clients (Möbius Sync, SyncTrain) can only sync while open or when iOS grants background time, so open the app and wait for 'Up to Date' before relying on files.
Syncthing Failed to Start Filesystem Watcher
Workaround availableLinux, NASOn Linux, Syncthing's watcher needs one inotify watch per directory and the default limit (about 8192) is too low for big folders. Raise fs.inotify.max_user_watches to 204800.
Syncthing High CPU Usage
Workaround availableWindows, macOS, Linux, NAS, AndroidSyncthing uses CPU to hash new or changed files and rescan folders; it should be near idle once everything is in sync. If it stays high, look for files that keep changing and cap cores with GOMAXPROCS.
Syncthing 2.0 Database Migration Stuck
Workaround availableWindows, macOS, Linux, NAS, DockerSyncthing 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.
Syncthing Deleted Files on All Devices
Workaround availableWindows, macOS, Linux, AndroidSyncthing replicates deletions, so files removed on one device disappear everywhere. Stop Syncthing on all devices immediately, then look for copies in .stversions (if versioning was on) or use disk recovery tools and backups.
Problem not listed? See all Syncthing complaints or compare Syncthing alternatives.
// We build software. Any software.
Have an idea for an app? We'll build it.
We're a small team of developers who build custom software fast. Not just tools like Syncthing: web and mobile apps, games, desktop software, AI tools, internal tools: whatever you have in mind. 50+ custom products built for clients so far, and we run our own products too: booking platforms, games, learning apps. See our work
- Web apps & SaaS
- Mobile apps (iOS & Android)
- Games
- Desktop software
- AI tools & automations
- Internal tools & dashboards
- Client portals & booking
- Your own version of any tool
- ✓ Free 15-min call to scope it
- ✓ Price agreed up front
- ✓ Your data, your code