// 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
Share

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

  1. FIX 1Reset the local sync database

    1. 01Quit the Nextcloud client
    2. 02Delete the hidden .sync_xxxxxxx.db file in the account's sync folder
    3. 03Restart the client (selective sync settings are reset)
    Did this fix it?
  2. FIX 2Stop other tools touching the folder

    1. 01Do not sync the same folder with Dropbox, rsync or Unison
    2. 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 us

Watch Nextcloud Get an email when its price changes, it has an outage, or we publish a new fix. No spam.

Fixed it? Share this guide

The same problem in other apps

All sync failures guides →

Other Nextcloud errors

All 10 Nextcloud errors and fixes →