Follow these suggestions to troubleshoot ShareGate database issues or post-installation errors
Update to the Latest Version
Ensure that you are running the latest version of ShareGate. Updates contain bug fixes and other improvements that can resolve the issue.
Restart ShareGate Migrate
To exit ShareGate Migrate completely, you must right-click on the ShareGate icon in the system tray and select Exit from the menu.
Try exiting the app entirely and then restarting it.
Reset and backup ShareGate Migrate's app data
This process will result in the loss of all your local ShareGate Migrate data, including your migration reports and tasks. You will need to manually recreate your connections, scheduled tasks, custom reports, and custom settings if you reset ShareGate Migrate's app data.
In some rare cases, it may be the only solution. If the solution does not work, you can restore the data from a backup you create during the process.
To reset and back up your app data, exit ShareGate Migrate completely (right-click the ShareGate icon in the system tray and select Exit from the menu).
Locate the Sharegate folder in the local application data directory (commonly found under C:\Users\%username%\AppData\Local).
Rename the folder to Sharegate_Backup (Any other name will work).
Restart ShareGate Migrate. This will automatically create a new app data folder with a fresh database.
If it doesn't work, you can exit the app, delete the new Sharegate folder that was created, rename the Sharegate_backup folder to Sharegate, and restart ShareGate Migrate to restore your app data.
Note: Restoring your data by copying folders from the old Sharegate directory to the new one is not supported.
Bringing elements back from an old or problematic database into a new one can cause unexpected behavior. If you restore an old folder, your app data, such as scheduled tasks and custom reports, may not carry over correctly.
If you still face a database or post-installation issue
Our support team will be happy to assist you in resolving the issue. To get a faster resolution, please provide the following information:
Are you using the latest version of ShareGate Migrate?
What was the error message you received?
What have you tried from this article? More details are often better than not enough.
