El temido error “folder marker missing” en Syncthing interrumpe en el acto la sincronización de carpetas entre dispositivos. Más que un error, se trata de un mecanismo de seguridad que a veces puede resultar un poco confuso. ¿Qué causa este problema y cómo solucionarlo? Te lo contamos todo a continuación.
Qué es el error «folder marker missing» en Syncthing
Syncthing es una herramienta extraordinaria para mantener archivos sincronizados entre dispositivos sin depender de la nube. Pero, como todo software que gestiona datos críticos, incluye mecanismo de seguridad que a veces pueden complicar un poquito las cosas. Tal es el caso del error “folder marker missing” en Syncthing, o marcador de carpeta faltante. ¿Lo tienes en pantalla?
Cuando este error aparece, la carpeta afectada se detiene por completo y la sincronización se interrumpe. ¿Qué provoca esto? Entendamos: dentro de cada carpeta que Syncthing gestiona, el programa espera encontrar un elemento oculto llamado .stfolder. Este elemento no es un archivo de datos común, sino un marcador de identidad y seguridad.
- Syncthing utiliza este archivo especial para identificar y comprobar la disponibilidad de las carpetas que participan en la sincronización.
- El archivo es una especie de marcador que permite al programa verificar que la ubicación configurada sigue siendo la correcta.
- Si el marcador no está, aparece el error “folder marker missing” en Syncthing y la sincronización se detiene para esa ubicación.
¿Por qué existe el archivo .stfolder?
El principal objetivo de esta medida es evitar que Syncthing trabaje accidentalmente sobre una carpeta equivocada. Imagina, por ejemplo, que tienes una carpeta sincronizada en un disco externo. Si este no se monta correctamente al iniciar el sistema operativo, la ruta de la carpeta aparecerá vacía para Syncthing. En este caso, ¿qué pasaría si el marcador .stfolder no existiera?
Que Syncthing asumiría que todos los archivos han sido borrados de la unidad externa, y entonces propagaría esa “eliminación” a todos los demás dispositivos. En otras palabras, destruiría por completo la copia de seguridad. Pero, al exigir la presencia del marcador .stfolder, Syncthing simplemente se detiene y lanza el aviso de que algo no anda bien con la carpeta sincronizada.
¿Qué causa el error «folder marker missing» en Syncthing?
El error “folder marker missing” en Syncthing puede desencadenarse por varias razones, que van desde lo accidental hasta lo técnico. La primera y más obvia causa es la eliminación accidental del directorio .stfolder por parte del usuario o de algún programa de limpieza. Como se trata de una carpeta oculta (comienza con un punto), es muy fácil pasarla por alto al mover archivos manualmente.
Otra cosa que provoca este fallo es cuando el disco externo no está conectado o no ha sido reconocido por el sistema. En Windows, por ejemplo, una unidad puede cambiar de letra después de conectar otros dispositivos. Y en Linux, un punto de montaje puede no estar disponible tras reiniciar el equipo.
Igual pasa si la ruta de la carpeta ha cambiado por alguna razón. Por ejemplo, si moviste, renombraste o reorganizaste carpetas compartidas, es posible que Syncthing siga buscando el marcador en la ubicación anterior. El problema también aparece cuando una ruta configurada apunta a una carpeta diferente de la que realmente contiene tus archivos.
Asimismo, en entornos de servidores NAS o configuraciones con Docker, los problemas de permisos hacen que aparezca el error “folder marker missing” en Syncthing. Si el usuario bajo el que se ejecuta Syncthing no tiene permisos de escritura en la ruta de destino, no podrá crear el marcador .stfolder. Esto pasa a menudo cuando se cambia la propiedad de los archivos o se montan volúmenes con permisos restrictivos.
Soluciones para el error «folder marker missing» en Syncthing
Si te encuentras con el error “Folder marker missing” en Syncthing, no entres en pánico. El error indica que Syncthing se ha detenido para proteger los datos, no que los haya perdido. Así que, si sospechas que el marcador se borró accidentalmente pero los archivos están intactos, la solución más rápida es volver a crear el marcador manualmente.
Recrea el marcador manualmente
¿Tienes acceso al sistema de archivos donde se encuentra la carpeta problemática? Lo tienes fácil: simplemente navega hasta la raíz de esa carpeta y crea un nuevo archivo llamado exactamente .stfolder. En la mayoría de los sistemas, puedes hacerlo desde la terminal con el comando mkdir .stfolder. Una vez creado, regresa a la interfaz web de Syncthing y pulsa el botón “Rescan”.
Corrige los permisos (especial para NAS y Docker)
Si el mensaje de error en los logs indica “operation not permitted” o “permission denied”, el problema es de permisos. Ten presente que, en sistemas como Asustor, FreeNAS o configuraciones con Docker, Syncthing suele ejecutarse con un UID específico (frecuentemente 1000). Entonces, lo que tienes que hacer es asegurarte de que ese usuario tenga permisos de lectura y escritura sobre la carpeta.
Una manera de estar seguros es cambiando el propietario de la carpeta con sudo chown -R 1000:1000 /ruta/a/tu/carpeta. Luego, ajusta los permisos con sudo chmod -R 775 /ruta/a/tu/carpeta. Toma en cuenta que esto modificará los permisos de todos los archivos existentes, así que úsalo con precaución.
Error “folder marker missing” en Syncthing: reconfigura la carpeta
¿No estás seguro de por qué aparece el error “folder marker missing” en Syncthing? En este caso, la opción más segura es eliminar la carpeta de la configuración de Syncthing (sin borrar los archivos del disco) y volver a añadirla. Así, la herramienta volverá a escanear la carpeta, creará un nuevo marcador y actualizará los archivos existentes, sin riesgo a perderlos.
Comprueba el montaje y el nombre del marcador
Por último, si la carpeta está en un disco externo, asegúrate de que esté montado antes de iniciar Syncthing. Una idea útil es añadir una dependencia en el servicio systemd para que espere la unidad de montaje. Y, si has personalizado el nombre del marcador en la configuración avanzada, verifica que ese nombre exacto exista en la raíz de la carpeta sincronizada.
En conclusión, el error “folder marker missing” en Syncthing es, en realidad, un guardián que te protege de desastres mayores. Un descuido, un problema de permisos o un fallo de montaje puede borrar el marcador. Pero, con las soluciones presentadas, podrás restablecer la sincronización y asegurarte de que tus datos sigan fluyendo de manera segura entre tus dispositivos.
Desde muy joven he sentido una gran curiosidad por todo lo relacionado con los avances científicos y tecnológicos, en especial aquellos que nos hacen la vida más fácil y entretenida. Me encanta estar al tanto de las últimas novedades y tendencias, y compartir mis experiencias, opiniones y consejos sobre los equipos y gadgets que uso. Esto me llevó a convertirme en redactor web hace poco más de cinco años, enfocado principalmente a los dispositivos Android y sistemas operativos Windows. He aprendido a explicar con palabras simples aquello que resulta complicado para que mis lectores puedan entenderlo fácilmente.