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,
