NAS Codex › Synology › Synology Drive not syncing: files skipped, errors and connection failures
Synology Drive not syncing: files skipped, errors and connection failures
Synology Drive Client keeps a log of files it could not sync and why. This page sets out Synology's three articles on the subject, all last updated in August 2026: why individual files do not sync, what the common Drive Client error messages mean, and what to check when the client cannot connect at all.
Written against: Synology Knowledge Center articles for DSM 7 series, DSM legacy versions and DSM Enterprise (all last updated 2026-08-13). Last Updated: November 2026. Vendor menus and wording change between versions; if yours differ, follow the vendor page linked under Sources.
Before anything else: if the data on this NAS is not backed up somewhere else, copy it off first. Do not continue with any step on this page until you have.
Fast Answer
Open Synology Drive Client > Logs to see which files did not sync and why. The most common reasons Synology lists are a sync rule excluding them, unsupported names (starting with ~, or containing characters such as * : ? " < > | on Windows), paths that are too long, unsupported Windows attributes, files open in other apps, and antivirus software. If the client says "connection failed", check the address, the account, and that port 6690 is open.
Why individual files do not sync
- Sync rules: in Synology Drive Client > Sync Tasks, select the task and open Sync Rules. Check the File Filter for a maximum file size or excluded extensions, and the Folder list; unselected folders do not sync. An administrator can also apply file filters through User Sync Profiles in Synology Drive Admin Console.
- Unsupported names: on Windows, names starting with
~or paths containing* : ? \ / " < > |; on macOS and Linux, names starting with~or containing\or/. - Paths too long: on Windows, a name or path over 247 characters; on macOS, a path over 768 characters or a name over 255; on Linux, a path over 2,048 characters or a name over 255.
- Windows file attributes: files with the OFFLINE, REPARSE_POINT, SYSTEM or TEMPORARY attribute do not sync. Synology says to remove the attribute (Microsoft's
attribtool can do this); TEMPORARY cannot be removed that way, but there is a Sync temporary files and folders option. - Locked or restricted files: a file open in another app may be locked. You also need permission to the file, and it must not be set to read-only.
- Antivirus or firewall: add Synology Drive Client and the sync folder to the antivirus allow list.
- Too many files: each model has a maximum number of files it can sync, listed on its specification page. Check the count in File Station (right-click the folder > Properties) and sync fewer folders if needed.
Common Drive Client error messages
- Untrusted SSL certificate / certificate changed: the NAS certificate was changed or expired, or the clocks are out of sync. Renew the certificate, sync time with an NTP server, then Edit Connection and re-enter the password.
- Authentication error: the password was changed, or the account was deactivated, removed or renamed. Re-enter the password via Edit Connection. If you see Maximum retries reached, an administrator should remove your IP from Control Panel > Security > Protection > Allow/Block List > Block List.
- Connected to a different server: often a VPN or a different network, or Synology Drive Server was reinstalled; check the network, or create a new connection.
- Client not up to date / incompatible versions: update both Synology Drive Client and Synology Drive Server.
- Access denied or no privileges: an administrator should check Control Panel > Application Privileges > Synology Drive.
- Syncing and backup have been disabled: in Synology Drive Admin Console, go to Settings > General > Enable/Disable Syncing and select Allow data syncing and backup.
- Less than 2 GB available, or quota reached: free up space or expand storage, or have an administrator raise the user quota (Control Panel > User & Group > Edit > Quota).
- Folder read-only / no write privileges: switch the task to download-only in Sync Rules > Sync Mode, or have an administrator change the shared folder's permissions.
- Missing local folder: Synology says network drives and removable devices such as USB drives and SD cards are not supported. Recreate the local folder with the same name and path, and check nothing else is locking it.
- Server shared folder is unmounted: an encrypted shared folder needs mounting in Control Panel > Shared Folder > Encryption > Mount.
"Connection failed"
Synology's checklist when Drive Client cannot connect: make sure the NAS is on and the network is stable; check the IP address, domain name or QuickConnect ID, username and password; make sure Synology Drive Server is installed and working; open port 6690 on your router for Synology Drive Client; and try reducing the NAS's MTU to the default 1500 or lower.
When to stop and get help
Be careful when recreating a sync folder. Synology warns that if Drive Client is set to remove locally deleted files from the NAS, pointing a task at a new empty folder can remove all the files on the server; create a new sync task instead. If the client keeps hitting "Maximum retries reached", your IP may be blocked; see can't sign in: IP blocked.
Questions
Why are some files not syncing in Synology Drive?
Synology lists sync rules excluding them, unsupported characters or names starting with ~, paths over the length limit, Windows attributes such as SYSTEM or TEMPORARY, files open in other apps, missing permissions and antivirus software. Synology Drive Client > Logs shows the reason for each.
What port does Synology Drive Client use?
Synology says to set up port 6690 on your router for Synology Drive Client, and to check the address, account and that Synology Drive Server is installed if you get "connection failed".
Can Synology Drive sync a USB drive or network drive?
No. Synology says network drives and removable devices such as USB drives or SD cards are not supported as local sync folders and recommends folders on the computer's own drives.
Sources
Every fact on this page comes from the vendor documents below, opened on 2026-11-17.
- Synology Knowledge Center: My files won't sync between Synology Drive and Drive clients. What can I do?
- Synology Knowledge Center: What are some common Synology Drive Client sync or backup task issues and how can I fix them?
- Synology Knowledge Center: What can I do when Synology Drive Client has trouble connecting to my Synology storage system?