How to fix synchronisation issues and start over

If your app is not synchronising properly or something got corrupted and you want to start over, follow this guide.

First, make a backup

In all cases, the most reliable way to fix synchronisation is to start from a recent JEX backup of your notes. Having such backup also ensure you don't lose anything while you're trying to fix synchronisation.

If one of your applications is in a good state and has all the data, you can create this JEX backup file from File => Export all => JEX

Otherwise, you may be able to get this backup file from the JoplinBackup folder in your home directory. This would have been created by the Backup Plugin, which is enabled by default.

To start over with Joplin Cloud or Joplin Server

  • From the desktop app:
  • Synchronise your data until the sync process stops (check the sidebar)
  • Install the Victor Plugin
  • Follow the plugin instructions to delete all your notes
  • Synchronise again, and wait for sync to be completed
  • Import your JEX file
  • Synchronise

To start over with other sync targets

For Nextcloud, Dropbox, OneDrive, etc.

  • Delete all the data on the sync target
  • From the desktop app, create a new profile
  • Import your JEX backup file
  • Synchronise your notes

Fixing your other devices

Once you've applied the above steps the sync target should be in a good state, and the desktop app too. If other devices are synchronising with this sync target, follow these instructions:

Desktop

This ensures that the old sync state doesn't end up corrupting the sync target again

Mobile

  • Delete the app
  • Reinstall it
  • Synchronise
9 Likes
Sync troubles - tons of notes deleted
Constantly throttled by OneDrive, cannot sync at all on fresh device
Sync
What to do after sync error
Joplin server db issues during syncing
Two questions regarding joplin cloud just purchased
Dropbox sync issue - Mac <-> Android
Joplin Workflow and Features Questions
How to clean revsions from sync target manually?
Cant decrypt a bunch of docs on 2nd computer
Sync issue decryption
SOLVED: Sync never ends, causes resources to balloon in size
I messed up the sync! Please HELP
Behaviour after restoring server snapshot?
Joplin Crash on Mac
Notebook from one profile appeared in another profile
Syncing Error: 'Could not open file, no such file or directory'
2025-08-28 - A particular note is no longer synchronising
SYNC
Syncing from iphone to local Joplin Server?
Be aware newbie - migrating server from one version to another
Banner: Press to set the encryption key
Fail-safe - Every day
Joplin Server Not synchronizing notes across devices
Could you please add the function of synchronization to FTP server
I want to start over
Joplin empty after Backup
Sync error
How to Wipe Joplin Cloud and Resync Only Current Notes
My fault, starting over
Problem syncing PRO Subscription!
Unable to sync after rebuild
100% CPU on MacOS
Joplin unable to find files(pictures, etc)
Some items cannot be synchronised
On Android devices, this is another way to fix synchronisation issues and start over
Sync issues with a particular file
New iPhone lost all notes, now what?
Syncing 101
Joplin Workflow and Features Questions
Error on file

Thanks for your help Laurent. Problem fixed :+1::ok_hand: