info_i_25x25.png See important information about Ubiquiti Devices and KRACK Vulnerability in this article. We will update this document as more information becomes available.

EdgeRouter - Upgrading EdgeOS firmware

 

Video Tutorial (Web GUI)


Instructions for Upgrading Via CLI


In this article, readers will learn how to update the EdgeRouter firmware via the CLI.

Currently two firmware images can be stored on the EdgeRouter. This is convenient; if an upgrade doesn't work properly, then it's easy to revert back to the old version. 

To see the current version:

ubnt@RTR:~$ show version 
Version:      v0.9.5
Build ID:     13450177
Build on:     08/15/12 01:02
Copyright:    2012 Ubiquiti, Inc
HW model:     EdgeRouter Lite 3-Port
HW S/N:       1226TDC9FDB170D87
Uptime:       18:03:12 up 4 min,  1 user,  load average: 0.32, 0.25, 0.11

You can add a new image from a local file or a URL:

ubnt@RTR:~$ add system image ?
Possible completions:
 <ISO_file>    File name or URL of system image file to be installed
 <ISO_URL>

For example to use a direct download link (use actual URL of course):

add system image http://dl.ubnt.com/...

To add a new image from a local file:

ubnt@RTR:~$ add system image egdeos-120821.tar
Preparing to upgrade... Done
Copying upgrade image... Done
Removing old image... Done
Checking upgrade image... Done
Finishing upgrade... Done
Upgrade completed
ubnt@RTR:~$

Note: When a new image is added, the entire /config directory is copied to the new image, so it will have the same configuration as the last saved config. Openvpn keys saved in /config/auth will also get copied.

To see both images and the status of which is running and which will be running after the next reboot:

ubnt@RTR:~$ show system image 
The system currently has the following image(s) installed:
v0.9.5.13455361.120821.0102    (default boot) 
v0.9.5.13450177.120815.0102    (running image) 
A reboot is needed to boot default image

After a reboot, the new image is both running and default:

ubnt@RTR:~$ show system image 
The system currently has the following image(s) installed:
v0.9.5.13455361.120821.0102    (running image) (default boot) 
v0.9.5.13450177.120815.0102

To see how much storage each image is using:

ubnt@RTR:~$ show system image storage 
Image name                        Read-Only   Read-Write        Total
------------------------------ ------------ ------------ ------------
v0.9.5.13455361.120821.0102           69060          460        69520
v0.9.5.13450177.120815.0102           69056        77428       146484

To switch to the other image, like if a revert is needed following upgrade:

ubnt@RTR:~$ set system image default-boot 
The system currently has the following image(s) installed:
v0.9.5.13455361.120821.0102    (running image) (default boot) 
v0.9.5.13450177.120815.0102    
Are you sure you want to switch images? (Yes/No) [Yes]: 
 Moving images... 
Done
Switched from
 Version:      v0.9.5.13455361.120821.0102
to
 Version:      v0.9.5.13450177.120815.0102

If you want to delete the other image, you have:

ubnt@RTR:~$ delete system image 
The system currently has the following image(s) installed:
v0.9.5.13455361.120821.0102    (running image) (default boot) 
v0.9.5.13450177.120815.0102    
You are about to delete image [v0.9.5.13450177.120815.0102]
Are you sure you want to delete ? (Yes/No) [Yes]: 
Removing old image... Done