info_i_25x25.png Due to unforeseen weather conditions we are experiencing higher chat wait times. Remember you can also submit a ticket and one of our support representatives will get back to you as soon as possible. We apologize for the inconvenience.

EdgeRouter - Upgrading EdgeOS Firmware


Overview


Readers will learn how to upgrade the firmware on an EdgeRouter using the 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.

NOTES & REQUIREMENTS:
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:

Upgrading via the GUI


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 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 currently installed firmware and storage space.

show version
df -h
show system image storage

2.  Delete the backup system image (not the currently running firmware) if additional storage space is needed.

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, 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 /home/ubnt/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.

reboot

Related Articles


Back to Top