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

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

  1. FIX 1Remount the storage

    1. 01Check that the drive or share holding the folder is connected and mounted
    2. 02Click Rescan; the error clears once .stfolder is visible again
    Did this fix it?
  2. FIX 2Move the folder back or update the path

    1. 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?
  3. FIX 3Recreate the marker

    1. 01Only if you're sure the folder contents are correct
    2. 02Create an empty folder named .stfolder in the folder root
    3. 03Put a small dummy file inside so cleaner apps don't delete it, and exclude the folder from cleaner apps
    Did this fix it?
  4. FIX 4Fix Docker paths

    1. 01Use the path as seen inside the container (e.g. /var/syncthing/MYDIR), not the host path
    2. 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 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 →