EdgeRouter - How to Upgrade the EdgeOS Firmware


Overview


Readers will learn how to upgrade the firmware on an EdgeRouter using UNMS, the Web UI, or the Command Line. The latest EdgeOS firmware can be downloaded from the EdgeRouter Downloads page.

NOTES & REQUIREMENTS: 
Applicable to the latest EdgeOS firmware on all EdgeRouter models. Please see the Related Articles below for more information.
 
Devices and products used in this article:

Table of Contents


  1. Upgrading via UNMS
  2. Upgrading via the Web UI
  3. Upgrading via the Command Line
  4. Related Articles

Upgrading via UNMS


The Ubiquiti Network Management System (UNMS) allows for easy remote device management and mass firmware upgrades for adopted devices. UNMS will automatically and periodically download and store the latest firmware releases, which can then be transferred to the EdgeRouter.

unms.png
GUI: Access the UNMS Controller Web Portal.

1. Navigate to the connection Firmware Manager  firmwaremanager.png  to verify the available firmware releases.

2. Navigate to the Devices  devices.png  to upgrade the relevant routers.

Actions > Upgrade devices firmware

upgradedevicesfirmware.png

3. Select the EdgeRouter devices that you wish to upgrade and click the Set Firmware Versions to the Latest button.

firmwareupgrade.png

4. Upgrade the selected device(s).

5. The EdgeRouter will automatically reboot once the firmware upgrade is complete.


Upgrading via the Web UI


Back to Top

GUI: Access the EdgeRouter Web UI.

1. Download the EdgeOS firmware from the EdgeRouter Download page.

2. Navigate to the System settings in the bottom left corner of the Web UI.

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

3. Select Upload a file and browse your filesystem for the EdgeOS firmware release you wish to upload.

4. Wait for the firmware upgrade to complete. 

NOTE: The firmware upgrade process is indicated with the  process.png  loading icon.

5. 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, log in to the command line.

CLI: Access the Command Line Interface. 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.

show system storage
Filesystem                Size      Used Available Use% Mounted on
/dev/root                 3.3G    169.0M      2.9G   5% /root.dev

show system image storage
Image name                        Read-Only   Read-Write        Total
------------------------------ ------------ ------------ ------------
v2.0.0.5155284.190104.0701            81684         1796        83480
v1.10.10.5210357.190714.1229          82328          348        82676

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 Web UI upgrade steps above.


Upgrading via the Command Line


Back to Top

You will need a way to transfer files to and from the EdgeRouter, such as a TFTP or FTP server.

CLI: Access the Command Line Interface. 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
Version:      v1.10.10
HW model:     EdgeRouter 6P

show system storage
Filesystem                Size      Used Available Use% Mounted on
/dev/root                 3.3G    169.0M      2.9G   5% /root.dev

show system image storage
Image name                        Read-Only   Read-Write        Total
------------------------------ ------------ ------------ ------------
v2.0.0.5155284.190104.0701            81684         1796        83480
v1.10.10.5210357.190714.1229          82328          348        82676

2.  Delete the backup system image if additional storage space is needed.

delete system image

3. Upgrade the EdgeRouter firmware using one of the three methods described below:

Upgrading the firmware from a local file using TFTP, FTP or SCP.

1. Download the EdgeOS firmware to a workstation.
2. Upload the image to the device using TFTP, FTP or SCP.
3. Upgrade the firmware using the previously uploaded image.

add system image /tmp/firmware.tar

Uploading the image directly from the Ubiquiti website using HTTPS.

1. Visit the EdgeMAX Download page and copy the firmware URL to your clipboard.
2. Add the image to the EdgeRouter directly using the previously copied URL.

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

Uploading from a remote file using TFTP, FTP or SCP.

1. Download the EdgeOS firmware to a workstation.
2. Upload the image to the device using TFTP, FTP or SCP.

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. Verify that the new firmware is set to be the default boot image.

show system image 
The system currently has the following image(s) installed:

v2.0.6.5208554.190708.0611     (default boot) 
v1.10.10.5210357.190714.1229   (running image) 

A reboot is needed to boot default image
NOTE: Use the set system image default-boot command to swap the boot images if needed.

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

reboot

Related Articles


Back to Top

EdgeSwitch - How to Upgrade the EdgeSwitch Firmware

Intro to Networking - How to Establish a Connection Using SSH


We're sorry to hear that!