// troubleshooting guide · syncthing
Syncthing Failed to Start Filesystem Watcher
- Status
- Workaround available
- platforms:
- Linux, NAS
- updated:
- November 16, 2026
- reports:
- 2
- Method
- how we research
RUNBOOK · syncthing/inotify-limit3 FIXES
// quick answer
On 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.
Most likely fix: Raise the limit permanently
How to fix it
// try these in order, the most common fix is first
FIX 1Raise the limit permanently
- 01Add fs.inotify.max_user_watches=204800 to /etc/sysctl.conf (or a file in /etc/sysctl.d/)
- 02Reboot or run sudo sysctl -p
Did this fix it?FIX 2Apply it immediately
- 01Run: echo 204800 | sudo tee /proc/sys/fs/inotify/max_user_watches
- 02Restart Syncthing
Did this fix it?FIX 3Reduce watched directories
- 01Add ignore patterns for huge directories you don't need (node_modules, caches)
Did this fix it?
Symptoms
The GUI shows 'Failed to start filesystem watcher for folder ... failed to set up inotify handler. Please increase inotify limits', and changes are only picked up at the periodic rescan.
Why it happens
- C-01Linux default inotify watch limit (around 8192 per user) is lower than the number of directories
- C-02Other apps (IDEs, Dropbox) using up the watch budget
// this guide also covers
- syncthing failed to start filesystem watcher
- syncthing increase inotify limits
- syncthing inotify
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
All plan limits, paywalls & watermarks guides →
Nextcloud Upload Size Limit and 413 Error (Nextcloud)
Dropbox Basic 3 Device Limit Reached (Dropbox)
pCloud Shared Link Traffic Limit Exceeded (pCloud)