Troubleshooting guide

Nextcloud Client Waiting for Sync: Check the Local Queue Before You Restart

Category: File Sync

Troubleshooting

Your Windows Nextcloud desktop client has been sitting at waiting for sync for several minutes, and files you saved locally are still not appearing on the server. Before you restart anything, confirm whether the client is genuinely idle or simply blocked by one local item. Open the client window and look at the activity list. If it shows a single file with a clock icon and no progress, the queue is waiting on that item, not on the server. Right-click the tray icon and choose to open the main window, then select the activity tab to see the exact filename. If the list is empty but the status still reads waiting, the client may be paused; check the pause toggle in the settings menu and resume if needed. Next, confirm the server is reachable by opening your Nextcloud URL in a browser on the same machine. A login page means the connection is fine; a timeout means the client cannot proceed until the network or server recovers. If the queue names a file, move that file out of the sync folder temporarily and watch whether the remaining items upload. A file locked by another program, such as an open spreadsheet, will hold the whole queue. This is the common cause of a nextcloud client waiting for sync state that never clears. To verify, create a small text file in the sync folder, wait thirty seconds, and check the web interface. If it appears, sync is restored. If the queue still stalls, note the filename and error text before changing settings, and restore any file you moved. For a guided review,

Network server cabling representing the Nextcloud storage backend

Ask for help.


Back to the service page · Ask about this exact symptom