--- title: Software Updates slug: litmusedge-v1/quickstart-guide/installation-and-deployments/software-updates description: You have several options for updating your version of Litmus Edge. docTags: createdAt: 2022-06-03T18:52:05.000Z --- You have several options to upgrade Litmus Edge. If you need to download an updated version of Litmus Edge, visit the [Litmus Central portal](https://central.litmus.io/). The upgrade process preserves your data and existing configurations. After the Litmus Edge software has been installed on a device, this upgrade process can be used throughout the lifetime of the device. # Important - You can't downgrade a lower version. - If needed, you can upgrade to the same version you're currently on. For example, if your current version is 3.3.1, you can upload the 3.3.1 UPD file again to your Litmus Edge instance. - An upgrade to an internal pre-release version is possible, but contains a warning. Pre-release versions are not upgradeable. - Creating a backup prior to upgrading is recommended. - You cannot upgrade if your controller is IDE. You must have a SATA controller to upgrade. - Software upgrades haven’t been validated yet on VirtualBox 6.1.x. An upgrade attempt running on VirtualBox 6.1.x may result in a corrupted and unrecoverable Litmus Edge instance. - If you want the same edge device configuration and setup on a fresh installation or with an update, you can use a template. See [Templates](docId\:Me1x3I4rPT_IIgNPCY1GA) for more information. :::hint{type="warning"} **Caution**: Software upgrades haven’t been validated yet on VirtualBox 6.1.x. An upgrade attempt running on VirtualBox 6.1.x may result in a corrupted and unrecoverable Litmus Edge instance. ::: # Upgrade Paths :::hint{type="warning"} **Important**: Before upgrading, make sure to review the list of planned [Deprecated Drivers](docId\:x7F6RogWGUb9AiJkZ8aFr) so that you can migrate to any recommended replacement drivers. ::: Review the following information for the required upgrade path of Litmus Edge versions. ## Simplified Upgrade Path You can follow this simplified upgrade path: 3.2.3 > 3.2.8 > 3.2.11 > 3.2.12 > 3.5.6 > Latest version For more detailed upgrade paths for specific versions of Litmus Edge, see below. ## Specific Upgrade Paths Refer to the table below for specific upgrade paths depending on your current version and the latest Litmus Edge version. | **Target version (right)** | **3.11.5** | | --------------------------- | ------------------------------------------------ | | **Current version (below)** | | | **3.2.x** | 3.2.3 > 3.2.8 > 3.2.11 > 3.2.12 > 3.5.6 > 3.11.5 | | **3.3.1** | 3.5.6 > 3.11.5 | | **3.3.2** | 3.5.6 > 3.11.5 | | **3.5.4** | 3.5.6 > 3.11.5 | | **3.5.5** | 3.5.6 > 3.11.5 | | **3.5.6** | 3.11.5 | | **3.11.0** | 3.11.5 | | **3.11.1** | 3.11.5 | | **3.11.3** | 3.11.5 | | **3.11.4** | 3.11.5 | # Litmus Edge-Litmus Edge Manager Compatibility Refer to the following table to review which versions of Litmus Edge and Litmus Edge Manager are compatible. | **Litmus Edge version (right)** | **3.0.x** | **3.1.x** | **3.2.x** | **3.3.x** | **3.5.x** | **3.11.x** | **3.16.x** | **4.0.x** | | --------------------------------------- | --------- | --------- | --------- | --------- | --------- | ---------- | ---------- | --------- | | **Litmus Edge Manager version (below)** | | | | | | | | | | **2.x** | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | # Upgrade Litmus Edge You have three options for upgrading Litmus Edge. ## Backup Checklist For backup purposes, you can complete the following tasks before doing a software upgrade. All configurations and settings are maintained and carried over after upgrading to a new version. :::hint{type="info"} **Note**: For Litmus Edge version 3.11.0 and later, you will need to download a backup before upgrading. ::: - [ ] Download all tags in a CSV file from **DeviceHub **>** Tags**. See [Manage Tags](docId\:G9ROOmPC3XZ4Zq6CbNONc). - [ ] Download flows files from **Flows Manager**. See [Manage a Flows Manager](docId\:OPLiUxbWehjB1orbsnQe5). - [ ] Export all flows from your **Analytics** groups. See [Manage Processors and Analytics Flows](docId\:exEMunifUlmNIucviFRsL) for more information. - [ ] Export the OPC UA hierarchy configuration JSON file from the **OPC **>** Hierarchy** pane. See [Manage Nodes](docId\:e7jjD9hUJ7EO2WjBNhwiu) for more information. - [ ] Create a Template from the **Template** tab in **System **> **Backup / Restore**. See the *Download a Template* section in [Manage Templates](docId\:Vge3AG1QmW9S7YJS7-2IB). - [ ] Create a support bundle from the **Support** section in **System **>** Support**. See [Support](docId\:b_UKFjBuLxq7q7liWxVkJ). - [ ] Make a backup of your system from the **Backup / Restore Configuration** section in **Settings **>** Backup / Restore**. See [Back Up a Device](docId:2DmvdQMHuALT7NPXDmUeu). ## Option 1: Upload Local File This is the recommended upgrade method. ### Before You Begin - Verify the current software version running on Litmus Edge in **System** > **Info** under the *General *section. - Download the correct version of the UPD file you want to upgrade to from the [Central Portal](https://central.litmus.io/). If needed, review the *Upgrade Paths* section above. ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/OSHlEj20xPjHShZnVR79a_image.png" size="80" width="1046" height="520" position="center" caption="Litmus Edge software version" showCaption="true"} ### Upload a New Version of Litmus Edge Software Once you have the correct UPD file, complete the following steps to upload it to your Litmus Edge instance. **To upload a new version of Litmus Edge:** 1. In Litmus Edge, navigate to **System **> **Device Management**. The *Device Management* pane appears. 2. From the* Software Update* section, click **Upload File**. For Litmus Edge version 3.3.1 and earlier, this button is in the *Manage *section. ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/ju7tgwvSHPyGVazdpW_w7_upload-file-button.png" size="80" width="838" height="124" position="center" caption="Software Update section" showCaption="true"} 3. Select the UPD file and click **Open**. 4. Click **Ok**. For Litmus Edge version 3.11.0 and later, follow the prompts to download a backup before proceeding with the upgrade. The software loads and installs. The progress of the upload will display. Once finished, the system reboots. 5. Once the system has restarted, close your browser and open the browser again. 6. Clear your browser cache. 7. Log in to Litmus Edge and navigate to **System > Info**. Verify the software version is the updated version. ## Option 2: Upgrade Through Litmus Edge Manager If you have access to Litmus Edge Manager, see the following for upgrading remotely: - [Software Update](docId:2vCj2fF1K9z-dd9sCfn0O) - [Add New Software Update Tasks](docId\:i24b2ShVA4EeOxUPftj_M) ## Option 3: Download Upgrade File :::hint{type="info"} **Note**: This option is available for Litmus Edge version 3.5.2 and later. ::: If the two options above are not available, then you can download the upgrade file from a URL. ### Before You Begin Visit the [Central Portal](https://central.litmus.io/) to download the correct UPD file locally to your computer and get the Checksum value you will need. Then, upload the file to your preferred file storage service. You will use the URL to access the file when entering the *Download URL* in Litmus Edge. ### Download the Upgrade File in Litmus Edge **To download the upgrade file in Litmus Edge:** 1. In Litmus Edge, navigate to **System **> **Device Management**. The *Device Management* pane appears. 2. In the *Software Update* section, click **Download from URL**. The *Download Software Update* dialog box appears. ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/ZnYdkUidCkhbgVbBsdGfh_download-from-url-link.png" size="80" width="838" height="124" position="center" caption="Download from URL link" showCaption="true"} 3. Enter or paste the *Download URL* and *Checksum *value in the required fields. Then, click **Start download**. When the download successfully completes, the file displays in the *Update Files* section. 4. For the downloaded file, click **Update**. For Litmus Edge version 3.11.0 and later, follow the prompts to download a backup before proceeding with the upgrade.