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 192.168.1.11 netmask 255.255.255.0
  4. Connect cable to ER-X port eth0
  5. Browse to https://192.168.1.1
  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 192.168.1.1 to confirm it’s working
    $ ping 192.168.1.1
  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 192.168.10.1 to confirm

Phase 2: Configure Althea Router

  1. Browse to http://192.168.10.1 (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