Flash and configure the Ubiquiti Edgerouter-X (ER-X)

Flashing the ER-X can be a bit challenging due to a 2 stage install, changing ports, and low level command line tasks. This is the checklist I use.

Phase 1: Flash Althea Firmware

  1. Download the erx-factory.tar file
  2. Download the erx sysupgrade file from Althea’s firmware page
  3. Set computer ethernet port to a manual IP like netmask
  4. Connect cable to ER-X port eth0
  5. Browse to
  6. Login with username ubnt password ubnt
  7. Say no to config wizard
  8. Click system button in bottom left
  9. Upgrade System Image,
  10. Select the erx-factory.tar image, confirm twice
    (router reboots into commandline-only OpenWRT image)
  1. Switch cable to eth1 port, wait for about 1 minute
  2. Ping to confirm it’s working
    $ ping
  1. Transfer the sysupgrade image to the device using ‘scp’
    $ scp ./erx-sysupgrade.bin [email protected]:/tmp/erx.bin
  1. ssh into device
    $ ssh [email protected]
  1. Run sysupgrade with the uploaded image:
    $ sysupgrade -n /tmp/erx.bin
  1. Change computer ethernet port to DHCP
  2. Move cable to ER-X port eth4
  3. Ping to confirm

Phase 2: Configure Althea Router

  1. Browse to (important: http:// NOT https://)
  2. Change Eth0 port from WAN to LAN or Mesh
    (WiFi and Ports → Ports)
  3. Set a Nickname
    Settings → Nickname
  4. Set Operator Payment Address
    (Advanced → Network Organizer → Organizer Payment Address)
  5. Enable Selling Bandwidth
    (Advanced → Selling Bandwidth)
  6. Check that the relay neighbor is visible
    (Selling Bandwidth → Neighbors)
  7. Disable Selling Bandwidth (optional)
    (Advanced → Selling Bandwidth)
  8. Add Exit Node (requires a working mobile SMS number to confirm)
    (Settings → Exit Node)
  9. (Optional) Transfer xDai funds using MetaMask to the router’s payment address
    (Advanced → Node Information → Payment Address)
  10. Complete remaining tasks on the Dashboard:
  11. Save Contact Info, Backup Wallet, Set WiFi SSID & Password, etc

Phase 3: Command Line

  1. Install packages
opkg update
opkg install nano
opkg install iperf3
  1. Add remote admin SSH keys to /etc/dropbear/authorized_keys