> ## Documentation Index
> Fetch the complete documentation index at: https://docs.memorybox.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Upgrading MemoryBox

> How to move to the latest version of the app and extension without losing your data.

## 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](https://docs.memorybox.ai/configuration/desktop-overview.md), 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.

> [!TIP]
>
> **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.

> [!WARNING]
>
> **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.

> [!NOTE]
>
> **Pre-upgrade Requirement:** Always ensure the MemoryBox daemon and app windows are fully closed before initiating a manual update.

> [tab] macOS
>
> **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.

> [tab] Windows
>
> **1. Terminate Background Processes**
>
> Right-click the MemoryBox tray icon positioned near your system clock in the lower-right Taskbar and select **Exit**.
>
> **2. Execute the Installer**
>
> Download a newer `.msi` package and execute it. The Windows installer module will automatically detect your old application files, overwrite them with the fresh build configuration, and safeguard your local runtime cache directory. A lower-version installer exits without changing your existing data.
>
> **3. Relaunch Application**
>
> Launch MemoryBox from your Windows Start Menu to initialize the updated software loop.

***

## 🌐 Browser Extension Upgrades

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

> [tab] Google Chrome
>
> **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.

> [tab] Mozilla Firefox
>
> **1. Open the Distribution Link**
>
> Open the updated extension distribution hyperlink provided in your invitation directly inside a Firefox browser tab.
>
> **2. Approve the Update**
>
> Firefox will automatically intercept the incoming network package and prompt you with a native browser overlay. Click **Update** to automatically refresh your active version.

> [!TIP]
>
> **Extension Upgrade Habit:** Regularly check for updates to your browser extension whenever you update the desktop application to maintain optimal integration and performance.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.