Troubleshooting guide
Nextcloud Desktop Client Stuck at 'Waiting for Sync' on Windows: A Controlled Diagnosis
Category: File Sync
You’re running a self-hosted Nextcloud server and the Windows desktop client stays at ‘waiting for sync’ while local files remain unsent. This is a nextcloud sync stuck state that needs a controlled diagnosis before you change anything.
Check the client’s sync engine status
Open the Nextcloud desktop client, click the account icon, and select ‘Recent activity’. Look for repeated ‘waiting’ entries or errors. If you see a specific file name stuck in the queue, note it. A blank activity log with no progress usually points to a paused sync or a locked database.
Next, check the client’s log file. On Windows, open File Explorer and go to %LOCALAPPDATA%\Nextcloud\logs. Open the most recent log and search for ‘sync paused’, ‘database is locked’, or ‘connection refused’. If you find ‘database is locked’, the client’s local database is busy; if you find ‘connection refused’, the client cannot reach your server.
Verify server reachability and account state
In a browser on the same Windows machine, open your Nextcloud web interface and log in. If the web interface loads, the server is reachable. Then, in the desktop client, right-click the account and choose ‘Open folder’. Confirm the local sync folder exists and is not on a disconnected network drive.
Verification test
Create a small text file in the local sync folder. Watch the client’s activity window for two minutes. If the file uploads and the status changes from ‘waiting’ to ‘up to date’, sync is restored. If it remains at ‘waiting’, the issue is likely the client’s local database or a paused sync state.
Rollback and recovery
Before making changes, back up the client’s configuration folder at %APPDATA%\Nextcloud. If a restart or re-login does not resolve the stuck state, you can restore this backup to return to the previous client state. For guided recovery,
