---
title: How to upgrade AltoPlex firmware
description: How to upgrade AltoPlex firmware. The role of the device (distribution node (DN) or client node (CN)) affects the sequence of upgrading.
---

[Skip to content](https://support.altowav.com/how-to-upgrade-altoplex-firmware#main-content)

[![AltowaveLogoRGB-crop-3](https://support.altowav.com/hubfs/AltowaveLogoRGB-crop-3.svg)](https://support.altowav.com/?hsLang=en-us)

Open main navigation

Close main navigation

- [Contact Support](https://support.altowav.com/contacting-altowav-technical-support)

[Contact Support](https://support.altowav.com/contacting-altowav-technical-support?hsLang=en-us)

 How can we help you?

- There are no suggestions because the search field is empty.

1. [Altowav Support](https://support.altowav.com/?hsLang=en-us)
2. [AltoPlex Radios](https://support.altowav.com/altoplex-radios?hsLang=en-us)
3. [Configuration](https://support.altowav.com/altoplex-radios?hsLang=en-us#configuration)

# How to upgrade AltoPlex firmware

#### **Upgrade roadmap**

The role of the device (distribution node (DN) or client node (CN)) affects the sequence of upgrading.

1. Download and unzip the firmware zip file from [Altoplex Firmware Downloads](https://support.altowav.com/hc/en-us/sections/14673026991513-AltoPlex-Firmware?hsLang=en-us) at [support.altowav.com](https://support.altowav.com?hsLang=en-us).
2. Upgrade the devices one at a time.
3. Always start with the distribution node furthest from the root node.
4. Make sure each upgrade finishes and all DN and CN links are re-established before moving on to the next distribution node.
5. Upgrade client nodes after the distribution nodes are upgraded.

#### **The firmware binary filename**

The following files are included in the firmware zip file:

- A digest file, not used as part of this upgrade process.
- The firmware binary.

The firmware binary filename consists of three parts:

\<*filetype*\>-\<*device\_family\_name*\>-\<*version\_number*\>

where:

- *filetype* is **kb\_sw-prod**
- *device\_family\_name* is one of: 
    - **NOMAD** — Firmware used for D621 and P621 devices.
    - **DEVO** — Firmware used for D423, C410, C420, and P421 devices.
- *version\_number* is the version number of the firmware.

For example:

kb\_sw-prod-NOMAD-4.2.0

#### **Upgrade from the WebUI**

1. Download and unzip the firmware zip file from [Altoplex Firmware Downloads](https://support.altowav.com/hc/en-us/sections/14673026991513-AltoPlex-Firmware?hsLang=en-us) at [support.altowav.com](https://support.altowav.com?hsLang=en-us).
   
   The following files are included in the firmware zip file:
   
     - A digest file, not used as part of this upgrade process.
     - The firmware binary. See [The upgrade software filename](https://support.altowav.com/upgrade-firmware.html#h) for information about the filename used for the firmware binary.
2. Access the WebUI of the AltoPlex device. In your browser's address bar, type:
   
   **https://*hostname***
   
   where *hostname* is the hostname (KB-XX-XX-XX) or IP address of the radio. See [Connecting to the AltoPlex radio](https://support.altowav.com/connect-to-the-altoreach-device.html#h3) for more information.
3. Click the **login** link in the WebUI header to log in as administrator. The default password is **admin**.
   
   ![](https://support.altowav.com/hs-fs/hubfs/kb-images/altoplex-radios/WebUI-login-link-with-wireless-tab_b61c241c.png?width=670&height=99&name=WebUI-login-link-with-wireless-tab_b61c241c.png)
4. Click the **Admin** tab.
5. Click the **Upgrade Firmware** button.
   
   ![](https://support.altowav.com/hs-fs/hubfs/kb-images/altoplex-radios/WebUI-D621-Admin-tab_upgrade-firmware_4982e9d4.png?width=670&height=230&name=WebUI-D621-Admin-tab_upgrade-firmware_4982e9d4.png)
   
   The **Firmware upgrade** dialog opens.
   
   ![](https://support.altowav.com/hs-fs/hubfs/kb-images/altoplex-radios/WebUI-firmware-upgrade_f1c2f833.png?width=300&height=221&name=WebUI-firmware-upgrade_f1c2f833.png)
6. Click **Choose File**.
7. Browse to the directory where the upgrade binary file was downloaded and select the file.
8. Click **Start Upgrade**.

#### Upgrade from the CLI

### Upgrade from the CLI by using Secure File Copy (scp)

Use Secure File Copy (scp) to upload a file from a remote host to the AltoPlex device and install the file:

1. Download and unzip the firmware zip file from [Altoplex Firmware Downloads](https://support.altowav.com/hc/en-us/sections/14673026991513-AltoPlex-Firmware?hsLang=en-us) at [support.altowav.com](https://support.altowav.com?hsLang=en-us).
   
   The following files are included in the firmware zip file:
   
     - A digest file, not used as part of this upgrade process.
     - The firmware binary. See [The upgrade software filename](https://support.altowav.com/upgrade-firmware.html#h) for information about the filename used for the firmware binary.
2. Log in via ssh to the AltoPlex device:
   
   $ ssh admin@\<*hostname*\>
   
   admin@\<*hostname*\>'s password:
   
   where *hostname* is the hostname (for example, KB-C7-00-01) or IP address of the radio. See [Connecting to the AltoPlex radio](https://support.altowav.com/connect-to-the-altoreach-device.html#h3) for more information.
3. Enter **control** mode:
   
   KB-C7-00-01\> control
   
   KB-C7-00-01(control)\>
4. Upload and install the software:
   
   KB-C7-00-01(control)\> software upgrade scp://*user*@*server*/*firmware\_filename*
   
   *where:*
   
     - *user* is the name of the user on the remote host.
     - *server* is the hostname or IP address of the remote host.
     - *firmware\_filename* is the path and filename of the upgrade software.
5. When prompted, type the password to log into the remote host.
   
   The upgrade software will be uploaded and installed on the D621. You can monitor the status of the upgrade by using the **software status** command:
   
   KB-C7-00-01(control)\> software status  
   current-software-version: 3.9.1  
   status: upgrading  
   running-sw-version: 3.9.1  
   new-sw-version: 4.2.0  
   upgrade-running: yes
   
   After the software upgrade completes, the device will reboot.

### Upgrade from the CLI by using a TFTP server

1. Download and unzip the firmware zip file from [Altoplex Firmware Downloads](https://support.altowav.com/hc/en-us/sections/14673026991513-AltoPlex-Firmware?hsLang=en-us) at [support.altowav.com](https://support.altowav.com?hsLang=en-us).
   
   The following files are included in the firmware zip file:
   
     - A digest file, not used as part of this upgrade process.
     - The firmware binary. See [The upgrade software filename](https://support.altowav.com/upgrade-firmware.html#h) for information about the filename used for the firmware binary.
2. Upload the binary file to the TFTP directory on your server. The TFTP server must be accessible from each device being upgraded.
3. Log in via ssh to the AltoPlex device:
   
   $ ssh admin@\<*hostname*\>
   
   admin@\<*hostname*\>'s password:
   
   where *hostname* is the hostname (for example, KB-C7-00-01) or IP address of the radio. See [Connecting to the AltoPlex radio](https://support.altowav.com/connect-to-the-altoreach-device.html#h3) for more information.
4. Enter **control** mode:
   
   KB-C7-00-01\> control
   
   KB-C7-00-01(control)\>
5. Upload and install the software:
   
   KB-C7-00-01(control)\> software upgrade tftp://*server*/*firmware\_filename*
   
   *where:*
   
     - *server* is the hostname or IP address of the TFTP server.
     - *firmware\_filename* is the path and filename of the upgrade software.
   
   The upgrade software will be uploaded and installed on the AltoPlex device. You can monitor the status of the upgrade by using the **software status** command:
   
   KB-C7-00-01(control)\> software status  
   current-software-version: 3.9.1  
   status: upgrading  
   running-sw-version: 3.9.1  
   new-sw-version: 4.2.0  
   upgrade-running: yes
   
   After the software upgrade completes, the device will reboot.

#### Upgrade from the REST API

1. Download and unzip the firmware zip file from [Altoplex Firmware Downloads](https://support.altowav.com/hc/en-us/sections/14673026991513-AltoPlex-Firmware?hsLang=en-us) at [support.altowav.com](https://support.altowav.com?hsLang=en-us).
   
   The following files are included in the firmware zip file:
   
     - A digest file, not used as part of this upgrade process.
     - The firmware binary. See [The upgrade software filename](https://support.altowav.com/upgrade-firmware.html#h) for information about the filename used for the firmware binary.
2. Upload the firmware image file to a server that can be access by all devices.
3. Use the configuration/software\_upgrade API to install the firmware file. For example: 
   
   curl -k -u admin:*\<password*\> \\  
   https://\<*hostname*\>/rest/v002/configuration/software\_upgrade \\  
   -X POST \\  
   -H "Content-Type:application/octet-stream" \\  
   -H "X-File-Name:\<*filename*\>" \\  
   --data-binary@\<*path*\>/\<*filename*\>
   
   Where:
   
     - *password* is the password to log into the device. The default password is **admin**.
     - *path* is the path to the firmware file. If the command is executed from the same local directory as the firmware file, path is not necessary.
     - *filename* is the name of the firmware upgrade file, for example, kb\_sw-prod-NOMAD-4.2.0.
     - *hostname* is the hostname or IP address of the radio being upgraded.
   
   The following example curl command uses the -i option to show the response headers, and demonstrates that the file transfer was successful and that the upgrade has begun:
   
   $ curl -i -k -X POST -u admin:admin \\
   
   -H "Content-Type:application/octet-stream" \\
   
   -H "X-File-Name:kb\_sw-prod-NOMAD-4.2.0.plain" \\
   
   --data-binary @kb\_sw-prod-NOMAD-4.2.0.plain \\
   
   https://10.0.0.01/rest/v002/configuration/software\_upgrade
   
   % Total % Received % Xferd Average Speed Time Time Time Current
   
   Dload Upload Total Spent Left Speed
   
   100 34.1M 100 88 100 34.1M 15 6358k 0:00:05 0:00:05 --:--:-- 6301kHTTP/1.1 100 Continue
   
    
   
   HTTP/1.1 200 OK
   
   Content-Type: application/json
   
   Cache-Control: public, must-revalidate, proxy-revalidate
   
   Content-Length: 88
   
   Date: Sat, 01 Jan 2025 00:23:39 GMT
   
   Server: lighttpd/1.4.73
   
   {
   
   "status":"starting",
   
   "running-sw-version":"3.9.1",
   
   "upgrade-running":"yes"
   
   }
   
   The upgrade may take up to several minutes to complete.

#### Verify that the firmware update was successful

### Verify firmware update from the WebUI

1. Open the WebUI.
2. The firmware version is displayed on the **Status** page in the **Device Information** section:
   
   ![](https://support.altowav.com/hs-fs/hubfs/kb-images/altoplex-radios/WebUI-D621-status-firmware_ea498df7.png?width=495&height=475&name=WebUI-D621-status-firmware_ea498df7.png)

### Verify firmware update from the command line

1. Log in via ssh to the AltoPlex device:
   
   $ ssh admin@\<*hostname*\>
   
   admin@\<*hostname*\>'s password:
   
   where *hostname* is the hostname (for example, KB-C7-00-01) or IP address of the radio. See [Connecting to the AltoPlex radio](https://support.altowav.com/connect-to-the-altoreach-device.html#h3) for more information.
2. Enter **control** mode:
   
   KB-C7-00-01\> control
   
   KB-C7-00-01(control)\>
3. Check the status of the device by using the **software status** command:
   
   KB-C7-00-01(control)\> software status  
   current-software-version: 4.2.0  
   status: idle  
   upgrade-running: no
   
   KB-C7-00-01(control)\>
   
   Verify that the current-software-version matches the expected value of the upgrade.

### Verify firmware update from the REST API

Use the device/node\_identity API to return the firmware version:

$ curl -k -u admin:admin https://KB-C7-00-01/rest/v002/device/node\_identity  
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current  
 Dload  Upload   Total   Spent    Left  Speed  
100   605  100   605    0     0   8188  0 --:--:-- --:--:-- --:--:--  8402{  
  "Ethernet MAC" : "70:88:6B:C7:00:01",  
  "HW name" : "nomad",  
  "HW rev" : 2,  
  "HW type code" : 82,  
  "Node role" : "DN",  
  "Number Ethernet Interfaces" : 1,  
  "Number RF Interfaces" : 1,  
  "Part number" : "1900-8411-1012-nomad-2-LBKA0ZZ1SV1",  
  "Serial number" : "000000000000000000001KB-C7-00-01:2",  
  "authorized\_org" : "",  
  "bootloader version" : "KBBLVERSION:1.3:prod:robot:2025-11-07\_11-57-10:nomad:1b565eb",  
  "description" : "system description not set",  
  "gps available" : 1,  
  "location" : "system location not set",  
  "name" : "KB-C7-00-01",  
  "node type" : "PTP",  
  "software" : "4.2.0"  
}

- [AltoPlex Radios](https://support.altowav.com/altoplex-radios?hsLang=en-us#main-content)

    - [First-Time Setup](https://support.altowav.com/altoplex-radios?hsLang=en-us#first-time-setup)
    - [Configuration](https://support.altowav.com/altoplex-radios?hsLang=en-us#configuration)
    - [Network Design & Deployment](https://support.altowav.com/altoplex-radios?hsLang=en-us#network-design-deployment)
    - [Troubleshooting](https://support.altowav.com/altoplex-radios?hsLang=en-us#troubleshooting)
- [AltoReach Radios](https://support.altowav.com/altoreach-radios?hsLang=en-us#main-content)

    - [First-Time Setup](https://support.altowav.com/altoreach-radios?hsLang=en-us#first-time-setup)
    - [Configuration](https://support.altowav.com/altoreach-radios?hsLang=en-us#configuration)
    - [Deployment & Aiming](https://support.altowav.com/altoreach-radios?hsLang=en-us#deployment-aiming)
    - [Troubleshooting](https://support.altowav.com/altoreach-radios?hsLang=en-us#troubleshooting)
- [K60 Radios](https://support.altowav.com/k60-radios?hsLang=en-us#main-content)

    - [First-Time Setup](https://support.altowav.com/k60-radios?hsLang=en-us#first-time-setup)
    - [Configuration](https://support.altowav.com/k60-radios?hsLang=en-us#configuration)
    - [Troubleshooting](https://support.altowav.com/k60-radios?hsLang=en-us#troubleshooting)
- [AltoCommand](https://support.altowav.com/altocommand?hsLang=en-us#main-content)

    - [Getting Started](https://support.altowav.com/altocommand?hsLang=en-us#getting-started)
    - [Dashboard & Monitoring](https://support.altowav.com/altocommand?hsLang=en-us#dashboard-monitoring)
    - [Device & Fleet](https://support.altowav.com/altocommand?hsLang=en-us#device-fleet)
    - [Management](https://support.altowav.com/altocommand?hsLang=en-us#management)
    - [Configuration](https://support.altowav.com/altocommand?hsLang=en-us#configuration)
    - [Map](https://support.altowav.com/altocommand?hsLang=en-us#map)
- [Product Reference](https://support.altowav.com/product-reference?hsLang=en-us)
- [Downloads & Resources](https://support.altowav.com/downloads-resources?hsLang=en-us#main-content)

    - [AltoPlex Docs](https://support.altowav.com/downloads-resources?hsLang=en-us#altoplex-docs)
    - [AltoReach Docs](https://support.altowav.com/downloads-resources?hsLang=en-us#altoreach-docs)
    - [K60 Docs](https://support.altowav.com/downloads-resources?hsLang=en-us#k60-docs)
    - [AltoPlex Firmware](https://support.altowav.com/downloads-resources?hsLang=en-us#altoplex-firmware)
    - [K60 (Gen2) Firmware](https://support.altowav.com/downloads-resources?hsLang=en-us#k60-gen2-firmware)
    - [AltoCommand Docs](https://support.altowav.com/downloads-resources?hsLang=en-us#altocommand-docs)
- [Account & Support](https://support.altowav.com/account-support?hsLang=en-us#main-content)

    - [Contacting Support](https://support.altowav.com/account-support?hsLang=en-us#contacting-support)
    - [Return & RMA](https://support.altowav.com/account-support?hsLang=en-us#return-rma)

[![altowav.com](https://support.altowav.com/hubfs/AltowaveLogoRGB-crop-2.svg "altowav.com")](https://altowav.com)

© 2026 Altowav. All rights reserved.