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

Common Drive Client error messages

"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.