// troubleshooting guide · nextcloud
Nextcloud Client CSync Unknown Error
- Status
- Workaround available
- platforms:
- Windows, macOS, Linux
- updated:
- November 16, 2026
- reports:
- 2
- Method
- how we research
RUNBOOK · nextcloud/csync-unknown-error2 FIXES
// quick answer
A corrupted local sync journal causes this; stop the client, delete the hidden .sync_*.db file and restart.
Most likely fix: Reset the local sync database
How to fix it
// try these in order, the most common fix is first
FIX 1Reset the local sync database
- 01Quit the Nextcloud client
- 02Delete the hidden .sync_xxxxxxx.db file in the account's sync folder
- 03Restart the client (selective sync settings are reset)
Did this fix it?FIX 2Stop other tools touching the folder
- 01Do not sync the same folder with Dropbox, rsync or Unison
- 02Let Nextcloud have exclusive access
Did this fix it?
Symptoms
The desktop client reports 'CSync unknown error' and stops syncing a folder.
Why it happens
- C-01Corrupted local sync database
- C-02Syncing the same folder with another tool
// this guide also covers
- nextcloud csync unknown error
- nextcloud client sync error
Still not working?
If Nextcloud keeps failing, you're not alone. See every Nextcloud problem users report or the alternatives people switch to.
Have an app idea? Our small team builds any software: web and mobile apps, games, desktop, AI tools. Price agreed together.
Talk to usThe same problem in other apps
Dropbox Not Syncing (Dropbox)
Google Drive Not Syncing (Google Drive)
Proton Drive Not Syncing on Windows (Proton Drive)
Tresorit Not Syncing Files (Tresorit)
Other Nextcloud errors
- Nextcloud Access Through Untrusted Domain Error
- Why Is Nextcloud So Slow?
- Nextcloud Upload Size Limit and 413 Error
- Nextcloud Desktop Client Sync Slow
- Nextcloud Sync Error: Connection Closed
- Nextcloud File Is Locked (423) Error
- Nextcloud Stuck in Maintenance Mode
- Nextcloud Internal Server Error After Update or App Install