Help Center Help Articles Professional Support Community RMA & Warranty Downloads Tech Specs

EdgeRouter - How to Upgrade the EdgeOS Firmware

Overview

Readers will learn how to upgrade the firmware on an EdgeRouter using UISP, the Web UI, or the Command Line. 

NOTES & REQUIREMENTS:
  • Applicable to the latest EdgeOS firmware on all EdgeRouter models.
  • The latest EdgeOS firmware can be downloaded from the EdgeRouter Downloads page.

Table of Contents

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

Upgrading via the Web UI

topology.gif

Firmware upgrade process when using HTTPS to upload the firmware image from a local workstation.

Follow the steps below to upgrade the EdgeRouter using the Web UI:

GUI: Access the EdgeRouter Web UI.

1. Open a Web Browser and enter https://192.168.1.1 in the address bar.

2. Log into the router using the default credentials.

Username: ubnt
Password: ubnt
NOTE:See the Beginners Guide to EdgeRouter article if you are experiencing issues connecting to the EdgeRouter Web UI.

3. Download the EdgeOS firmware from the EdgeRouter Downloads page to a workstation.

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

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

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

6. Wait for the firmware upgrade to complete. 

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

7. 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 UISP

Back to Top

UISP allows for easy remote device management and mass firmware upgrades for adopted devices. UISP will automatically and periodically download and store the latest firmware releases, which can then be transferred to the EdgeRouter.

Follow the steps below to upgrade the EdgeRouter firmware using UISP:

GUI: Access the UISP Controller Web Portal.

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

2. Select the Upgrade devices option on the EdgeRouter that you wish to upgrade.

3. Choose to either schedule the update or upgrade the firmware directly (select ▼).

upgrade.png

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

Upgrading via the Command Line

Back to Top

Using the CLI, the firmware can be upgraded using three different methods:

  • Upgrading the firmware using a local image that was previously uploaded using TFTP, FTP or SCP.
  • Downloading the image directly from the Ubiquiti website using HTTPS.
  • Downloading the image from a remote server using TFTP, FTP or SCP.

Follow the steps below to upgrade the EdgeRouter firmware using the CLI:

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 using a local image that was previously uploaded 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

Downloading 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.ui.com/.../firmware.tar

Downloading the image from a remote server 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

EdgeRouter - Beginners Guide to EdgeRouter

EdgeRouter - How to Access the EdgeRouter

Intro to Networking - How to Establish a Connection Using SSH

Was this article helpful?