> For the complete documentation index, see [llms.txt](https://docs.anthriq.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.anthriq.com/bxi-studio/operations/firmware.md).

# Update BXI Studio

Check the current installed version of BXI Studio under **Help > About BXI Studio**.

## Download updates

BXI Studio checks for updates automatically on launch when an internet connection is available. For air-gapped installations, download the installer from [Getting Started](/bxi-studio/installation.md) and apply it manually.

## Install the update

### Windows

1. Close BXI Studio before installing the update.
2. Run the downloaded installer (`.exe`). The installer replaces the existing installation while preserving configuration and license data.
3. Relaunch BXI Studio after installation. Verify the new version under **Help > About BXI Studio**.

### macOS

1. Close BXI Studio.
2. Open the downloaded `.dmg` file and drag `BXI Studio.app` to the Applications folder. Overwrite the existing application when prompted.
3. Relaunch from the Applications folder. macOS may prompt to allow the updated application — click **Open**.

### Linux (Debian/Ubuntu)

1. Close BXI Studio.
2. Run:

   ```bash
   sudo dpkg -i bxi-studio-<version>.deb
   ```
3. Relaunch BXI Studio.

> **Warning:** Do not force-quit BXI Studio during a session update or while a device is acquiring data. Close active sessions before updating.

## After updating

After each update:

* Reconnect hardware devices — device drivers may update as part of the BXI Studio package.
* Verify plugin compatibility under **Plugins > Plugin Manager**. Plugins that require an updated API version are flagged as "Incompatible" and disabled automatically.
* Review the [Changelog](/bxi-studio/changelog.md) for breaking changes that affect your workflow or SDK integrations.