Troubleshooting guide
Nextcloud Sync Stuck: Check Status, Permissions, and Conflicts
Category: File Sync
nextcloud not syncing.
Nextcloud sync failures often look alike in the tray icon. Use one folder and read the actual client state before changing server configuration.
Before you start
- Nextcloud desktop client version
- One account with access to a test folder
- Server URL and the client's recent log
- Permission to create and delete a test file
Step-by-step checks
Step 1: Capture the client state
Open the Nextcloud client's activity window and note the last completed action, the current error, and the time. Export or copy the relevant log lines before restarting.
Check: You have a timestamped error or a clear “up to date” state.
Step 2: Create a clean test folder
Make a new folder on the server and connect only this client to it. Do not reuse a folder with existing conflict files or selective-sync exclusions.
Check: The client shows the new folder with no excluded subfolders.
Step 3: Test local to server
Create a small text file locally, wait for the client to report completion, and open the server copy in a browser. Compare content and modification time.
Check: The server copy appears with the same content.
Step 4: Test server to local
Edit the server copy, wait for the client to fetch it, and open the local file. If only one direction works, record the permission or error message.
Check: The local copy reflects the server edit after a refresh.
Step 5: Check restart persistence
Restart the client, make one more edit, and confirm it syncs without a manual rescan. Review whether a conflict file was created.
Check: The change syncs after restart and no new conflict appears.
Verify the result
Both directions work, the timestamps are plausible, and no new conflict file appears after restart. Keep the test folder until the next normal sync cycle succeeds.
Rollback
Remove only the test folder after verification. Do not delete conflict files or server data as part of the test.
Ask for help with this exact symptom · All troubleshooting guides