Frequently Asked Question
How do I set up Qsync on a Mac and verify the correct folders are synchronising?
QUICK ANSWER
Qsync needs a supported client on the Mac, Qsync Central on the NAS and permission to the intended folder. Confirm the selected task direction before moving or deleting files.
Applies to: Qsync for macOS with a supported QNAP NAS. Current Qsync Client6 layouts/features differ from the historical client illustrated in older versions of this guide.
Work through these checks
- Check the supported combination. Record macOS, Qsync Client and Qsync Central versions. Obtain the supported client for the Mac and verify the NAS application is running.
- Enable the intended NAS folder. Have the administrator confirm the user's application/shared-folder permissions and that the intended shared folder is available for Qsync. Do not enable unrelated shares merely to simplify discovery.
- Connect the correct NAS account. Use the intended secure address and authorised account. Check the certificate/connection result and confirm this is the correct NAS before choosing a folder pair.
- Review the folder pair and direction. Choose one clearly labelled local folder and its intended NAS destination. Read the sync direction, filtering, space-saving and deletion behaviour before accepting the pair.
- Test both required directions. Keep a separate backup and use harmless test files. Check what happens after a local edit and a NAS-side edit according to the chosen sync mode.
- Check history before changing the task. If a file is missing or returns after deletion, review filters, logs, permissions and the version history. Preserve unsynced work before recreating a task.
Confirm the result
The expected files appear at the correct destination and their content matches. A Connected or Up to date label alone is not a complete file check.
Before going further: Two-way sync can propagate deletions. Do not unlink/recreate a task or remove a local folder before preserving unsynced files and understanding its behaviour.
If you need help
Include these details in your ticket: macOS/client/server versions, sync direction, folder-pair layout and one anonymised missing-file example.
Related guidance: Why does Qsync skip particular files even though other files synchronise?
Updated 261110