// 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
Share

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

  1. FIX 1Raise the limit permanently

    1. 01Add fs.inotify.max_user_watches=204800 to /etc/sysctl.conf (or a file in /etc/sysctl.d/)
    2. 02Reboot or run sudo sysctl -p
    Did this fix it?
  2. FIX 2Apply it immediately

    1. 01Run: echo 204800 | sudo tee /proc/sys/fs/inotify/max_user_watches
    2. 02Restart Syncthing
    Did this fix it?
  3. FIX 3Reduce watched directories

    1. 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 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 plan limits, paywalls & watermarks guides →

Other Syncthing errors

All 12 Syncthing errors and fixes →