Skip to main content

​
The Preferred In-App Upgrade Path

Starting with Alpha 3, the easiest way to check for and install updates is directly within the desktop application interface. As outlined in the Desktop App Overview, clicking your user profile tray in the bottom-left corner and selecting About MemoryBox launches the platform’s diagnostic integrity card. Clicking the Check for updates button on that modal automatically pings our secure distribution network. If a newer stable build is available, the system will prompt you to download and initialize the installation immediately.
Upgrade Habit: We recommend using your routine desktop app upgrades as a reminder to check for the latest browser extension update as well!

​
Manual “Safe-Swap” Desktop Upgrades

Because MemoryBox enforces a strict local-first architecture, your Knowledge Base (the SQLite database and vector search directories containing your memories) is stored completely separate from the execution binaries. You can replace application files with the same or a newer MemoryBox version while leaving your saved data untouched.
Downgrades are not supported: Do not install an older MemoryBox version over data already opened by a newer version. MemoryBox checks the data version before startup and exits without modifying the data when the application is too old. The installer never deletes your data automatically. If support asks you to start over with an older version, first back up the entire MemoryBox data directory and follow the platform-specific uninstall and cleanup instructions they provide.
Pre-upgrade Requirement: Always ensure the MemoryBox daemon and app windows are fully closed before initiating a manual update.
1

Quit MemoryBox

Ensure the application processes are terminated. Check your top system Menu Bar for the floating MemoryBox icon, click it, and select Quit.
2

Remove Legacy Version

Navigate to your Applications directory and drag the old MemoryBox app icon into the Trash. (Note: Your local library path containing your indexed knowledge base remains untouched).
3

Install Target Build

Download a newer .dmg image from your authorization link, mount it, and drag the fresh version directly into your Applications folder. An older app may be copied manually, but MemoryBox will block it from opening newer data when it starts.
4

Initialize and Launch

Launch the new application build. MemoryBox will automatically detect your existing Personas, localized Memory Spaces, and historical chat assets on startup.

​
🌐 Browser Extension Upgrades

To ensure seamless integration between your browser and local workspace, keep your browser extension aligned with your desktop app version.
1

Remove Legacy Extension

In Chrome, right-click the MemoryBox extension icon in your toolbar and select Remove from Chrome… (or navigate to chrome://extensions and click Remove on the MemoryBox extension card).
2

Install Latest Build

Visit the official Chrome Web Store page for MemoryBox and click Add to Chrome to download and install the latest release.
3

Reconnect Extension

Click the newly installed extension icon in your toolbar to verify connection with your local MemoryBox desktop application.
Extension Upgrade Habit: Regularly check for updates to your browser extension whenever you update the desktop application to maintain optimal integration and performance.