EdgeRouter - Upgrading EdgeOS Firmware


Readers will learn how to upgrade the firmware on an EdgeRouter using UNMS, the EdgeOS Graphical User Interface (GUI), or the Command Line Interface (CLI). Currently, two firmware images can be stored on the EdgeRouter. This means that it is possible to revert back to the old firmware if the device fails to upgrade or the new firmware is corrupted (see the CLI commands below on how to swap images).

You can find the latest EdgeOS firmware in the EdgeMAX downloads section.

Applicable to the latest EdgeOS firmware on all EdgeRouter models. Knowledge of the Command Line Interface (CLI) and basic networking knowledge is required. Please see the Related Articles below for more information.
Devices used in this article:

Table of Contents

  1. Upgrading via UNMS
  2. Upgrading via EdgeOS GUI
  3. Upgrading via CLI
  4. Related Articles

Upgrading via UNMS

Back to Top

UNMS (Ubiquiti Network Management System) allows for easy remote device management and mass firmware upgrades once the devices are adopted into UNMS. UNMS will automatically and periodically download the latest firmware listed on ubnt.com/download to the UNMS server to then be transferred to the device using the steps below.

1. Verify available firmware in the UNMS firmware manager tool.


2. Click Devices. 


3. Click Actions > Upgrade Devices Firmware


4. Select devices and click the Set Firmware Versions to the Latest button.


Upgrading via EdgeOS GUI

Back to Top

1. Download the EdgeOS firmware from the the EdgeMAX downloads section. In the EdgeOS GUI navigate to the System settings (bottom left corner) and upload the new firmware to the device.

System > Upgrade System Image > Upload a file...

2. Wait for the firmware to be uploaded and installed.

3. Reboot the device when prompted.

ATTENTION: If the firmware fails to install it is likely that the EdgeRouter's storage is full. 

To verify any storage issues, please log in to the CLI.

CLI: Access the command line interface (CLI). You can do this using the CLI button in the GUI or by using a program such as PuTTY.

1. Verify the current filesystem and how much space is taken by the old firmware images.

sudo df -h
show system image storage

2. If additional storage space is needed, you can safely delete the backup system image (not the currently running firmware).

delete system image

3. Retry the upgrade above.

Upgrading via CLI

Back to Top

CLI: Access the command line interface (CLI). You can do this using the CLI button in the GUI or by using a program such as PuTTY.

1. Verify the currently installed firmware and storage space.

show version
df -h
show system image storage

2.  Delete the backup system image if additional storage space is needed. This command removes the previous firmware file only and does not remove any configuration settings.

delete system image

3. Add the image to the EdgeRouter, you can do so with one of the three methods described below: from a local file, from the UBNT website, or from a remote file. Once done, proceed to step 4 below.

From a local file:

1. Download the firmware image to a workstation.

2. Upload the image to the device using SCP, FTP, TFTP, etc.

3. Add the image to the EdgeRouter from the local device (home folder for example).

add system image /tmp/firmware.tar

Directly from the UBNT website via HTTPS:

1. Visit the EdgeMAX downloads section and copy the link to the download URL.

2. Add the image to the EdgeRouter using the HTTPS link

add system image https://dl.ubnt.com/.../firmware.tar

From a remote file using SCP, FTP, TFTP, etc:

1. Download the firmware image to a workstation.

2. Add the image to the EdgeRouter using the appropriate link.

add system image tftp://ip-address/firmware.tar 
add system image scp://ip-address/firmware.tar
add system image ftp://ip-address/firmware.tar

4. For all above steps, the next one would be to verify that the new image is set to default boot. Do so with the following command:

show system image
NOTE: If you want to swap images, the command is set system image default-boot.

5. Reboot the device to activate the new firmware image.


Related Articles

Back to Top

Intro to Networking - How to Establish a Connection Using SSH

EdgeSwitch - Firmware Upgrade

We're sorry to hear that!