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 Web App
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.
If you can see your latest content in the web app, please follow the next steps:
Close the Heptabase desktop app completely.
Delete the
project-metafolder.Windows: Go to the address bar of your system file manager, paste
%USERPROFILE%\AppData\Roaming, find theproject-metafolder, and delete it completely.
Mac: Go to the Finder of your Mac, pressCmd + Shift + G, then paste~/Library/Application Support, find theproject-metafolder, and delete it completely.
Linux: You can find theproject-metafolder in the following path~/.config/project-meta. Please delete it completely.
Note: This removes only local data. Your cloud data remains untouched.
Restart your Heptabase desktop app.
Once you reopen Heptabase, it will re-download all your data from the cloud. 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.