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


Back to the service page · Ask about this exact symptom