If you open the Desktop app, see this screen, and it doesn't finish within a minute, please follow the steps below to resolve the issue.
Check your cloud copy first
First, log in to the Heptabase Web App to verify that your notes and files are syncing properly there. If everything looks good online, you can proceed to the next steps.
If you can’t access the web app or see your most recent synced content, please DON'T proceed to the next steps—you might lose any unsynced local data.
If you encounter this issue, please contact us directly with any error messages or details.
Restart from the cloud copy
Continue only if your latest content is visible in the web app.
1. Quit Heptabase
Close the desktop app completely.
2. Delete the project-meta folder
Use the instructions for your operating system:
Windows
Paste this path into File Explorer’s address bar. Find the project-meta folder and delete it completely.
%USERPROFILE%\AppData\Roaming
Mac
In Finder, press Cmd + Shift + G and paste this path. Find the project-meta folder and delete it completely.
~/Library/Application Support
Linux
Delete the project-meta folder at this path:
~/.config/project-meta
This removes only local data. Your cloud data remains untouched.
3. Restart Heptabase
Reopen the desktop app. It will download your data from the cloud again, and the “Running core upgrade” screen should no longer be stuck.
Please note that deleting local files is risky. If you run into any issues other than the "Running core upgrade" problem, please don't delete any files unless instructed to do so.
If the issue recurs or persists, please contact us directly with any error messages or details.
Why does this issue occur?
This issue often happens because your desktop data schema is outdated and can't upgrade properly to the latest version, causing it to stall. However, if your cloud data is correct, you can download it to your desktop to resolve the problem.