// troubleshooting guide · syncthing
Syncthing Folder Marker Missing Error
- Status
- Workaround available
- platforms:
- Windows, macOS, Linux, Android, Docker/NAS
- updated:
- November 16, 2026
- reports:
- 4
- Method
- how we research
RUNBOOK · syncthing/folder-marker-missing4 FIXES
// quick answer
Syncthing 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.
Most likely fix: Remount the storage
How to fix it
// try these in order, the most common fix is first
FIX 1Remount the storage
- 01Check that the drive or share holding the folder is connected and mounted
- 02Click Rescan; the error clears once .stfolder is visible again
Did this fix it?FIX 2Move the folder back or update the path
- 01Restore the original path, or remove the folder in the GUI and add it again at the new path with the same Folder ID
Did this fix it?FIX 3Recreate the marker
- 01Only if you're sure the folder contents are correct
- 02Create an empty folder named .stfolder in the folder root
- 03Put a small dummy file inside so cleaner apps don't delete it, and exclude the folder from cleaner apps
Did this fix it?FIX 4Fix Docker paths
- 01Use the path as seen inside the container (e.g. /var/syncthing/MYDIR), not the host path
- 02Make sure the volume is mounted and the container user (PUID/PGID) can write to it
Did this fix it?
Symptoms
The folder shows an error 'folder marker missing' or 'folder path missing' and stops syncing.
Why it happens
- C-01External drive or network share not mounted
- C-02Folder moved or renamed on disk
- C-03Cleaner or gallery apps on Android deleted the empty .stfolder directory
- C-04Docker/NAS install pointing at the host path instead of the container path
// this guide also covers
- syncthing folder marker missing
- syncthing folder path missing
- syncthing .stfolder missing
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)