EdgeRouter - Beginners Guide to EdgeRouter


Readers will learn how to connect to and setup an EdgeRouter for the first time. There are many different environments where specific adjustments may need to be made. This article demonstrates a common setup scenario, but it is not necessary applicable in every network environment.

  • Setup wizards were added to the Web UI starting from the EdgeOS v1.4.0 firmware.
  • It is highly recommend to upgrade to the most recent firmware release before following this guide. See the How to Upgrade the EdgeOS Firmware article for more information.
  • Applicable to the latest EdgeOS firmware on all EdgeRouter models.

Table of Contents

  1. Establishing Initial Connectivity
  2. Running the Basic Setup Wizard
  3. Related Articles

Establishing Initial Connectivity

Back to Top

Follow the steps below to access the device via HTTPS using a web browser. Accessing the device requires you to configure a static IP address on the client machine (workstation). There are two examples below on how to do this on a Windows  windows.png  and macOS  macos.png  client.


Connecting an Ethernet cable between the EdgeRouter and a workstation that is configured with a static IP address.

1. Connect an Ethernet cable from a computer to the eth0 interface on the EdgeRouter.

2. Configure a static IP address on your computer in the range (for example

  windows.png  Windows Client

Navigate to the Windows 10 Network connections.
Settings > Network & Internet > Status > Change Adapter Options
Modify the IPv4 settings of the Ethernet adapter.
Ethernet Adapter > Properties > Internet Protocol Version 4 (TCP/IPv4) > Properties
Select to manually enter an IP address and add the following information:

IP address:
Subnet mask:
Default gateway: <blank>
DNS servers: <blank>


 macos.png  macOS client

Navigate to the macOS Network connections.
System Preferences > Networks > Ethernet Adapter
Select to manually enter an IP address and add the following information:

IP Address:
Subnet Mask:
Router: <blank>
DNS server: <blank>


ATTENTION: If a wireless adapter is enabled and connected to another network it could conflict with the connection to the EdgeRouter. Disable the wireless adapter if necessary. 
If you are unable to connect to the EdgeRouter, then consider using either the WiFiman Desktop or Ubiquiti ISP Management and Business software (UISP).

3. Open a Web Browser and enter in the address bar.

4. Log into the router using the default credentials.

Username: ubnt
Password: ubnt

5. Verify if the device is running the latest firmware from our Downloads page. Make sure to upgrade it before continuing on to the next section.

NOTE: There is more information about how to upgrade the EdgeRouter in the How to Upgrade the EdgeOS Firmware article.

Running the Basic Setup Wizard

Back to Top

The Basic Setup wizard which will accomplish all the necessary tasks to allow your router to connect to the Internet, including enabling the default firewall, setting up a Local Area Network and adding a DHCP Server. Each item is explained in more detail below.

NOTE: The current configuration will be replaced and a reboot is required when running the setup wizard.

1. Navigate to the Wizards tab and run the wizard.

Wizards > Basic Setup

2. Choose the interface that will connect to the ISP define the other router settings.

The available internet connection types are:

  • DHCP The most common scenario. Use this option if your ISP is distributing IP addresses via DHCP.
  • Static IP Use this option if your ISP provided you with a static public IP address.
  • PPPoE Use this option if your ISP authenticates your internet connection using PPPoE.
NOTE: It is recommended to configure the ISP supplied modem/router in bridge mode. This setting will forward the public IP from the ISP modem/router to the EdgeRouter.

The other available options are:

  • VLAN It is becoming more common for ISPs to provide FTTH (Fiber to the Home) and require that the Internet be distributed using a VLAN to separate Internet from IPTV and Voice services. Use this option to tag the Internet connection with a VLAN ID.
  • Firewall Enabled by default. See the How to Create a WAN Firewall Rule article for more information on the default firewall policies.
  • DHCPv6 If your ISP supports IPv6 using DHCPv6-PD, you will need to assign the supplied Prefix length given from the ISP, enable the default IPv6 firewall, and define the LAN interfaces that will need IPv6 connectivity.
  • LAN IP Address Set to by default. Change if necessary.
  • DHCP Server Enabled by default.
  • Username Set to ubnt by default. We strongly recommend that you configure your own user account with a strong password.
NOTE: When configuring a router with a built-in switch (such as the ER-12, ER-12P, ER-10XER-X or ER-X-SFP), the LAN will be set to the switch0 interface. In this case, all ports assigned to the switch will share the same LAN.

3. Apply the changes and reboot the router when prompted.

4. Unplug and reconnect the interfaces so that eth0 is connected to the ISP and the other port(s) are connected to your LAN.

ATTENTION: The computer's Ethernet connection can be changed back to DHCP if the DHCP server was enabled in the wizard.

 5.   See the DHCP Server and DHCP Server Using Dnsmasq articles for more information on the EdgeRouter DHCP server settings. 

Related Articles

Back to Top

EdgeRouter - How to Upgrade the EdgeOS Firmware

EdgeRouter - How to Access the EdgeRouter

EdgeRouter - How to Create a WAN Firewall Rule

EdgeRouter - Hardware Offloading

Intro to Networking - How to Establish a Connection Using SSH

Was this article helpful?
579 out of 963 found this helpful