Device Setup

The guide below covers how to complete the initial configuration in order to get flexiEdge device connected to the internet and registered with flexiManage.

Initial configuration

flexiEdge can be installed on a variety of supported devices or delivered pre-installed from our certified hardware vendors. After installing flexiEdge or receiving a device with flexiWAN pre-installed, initial network configuration is required in order to connect the device to internet and register with flexiManage.

flexiEdge webUI

Local flexiEdge UI purpuse is to provide an easy initial configuration and troubleshooting. Afterwards the device configuration is completed from flexiManage. flexiEdge UI is enabled by default on all of wired interfaces and it can be accessed using device IP via port 8080. flexiEdge UI can only be accessed if the device has an active network interface.

To access the local flexiEdge UI, open a browser and point it to the IP and port 8080 of currently active network interface on flexEdge device. Example:


After opening the flexiEdge UI page, enter username and password used when installing flexiWAN on the device. (default: admin / flexiwan).


Upon logging in with credentials, Home page will display device information and status. From the sidebar additional options can be accessed.


The sidebar follows post-installation configuration flow:

  1. System Checker - running system checker verifies your device can run flexiWAN

  2. Interfaces - Configuring network interfaces for internet access

  3. Settings - inserting token to connect the device to your flexiManage account.

After completing all three steps the device will be connected to your flexiManage account and waiting for approval.

Running system checker

System checker is a post-installation tool which verifies system requirements and fixes software configuration errors.

Click on System Checker page and run it to check if the system meets the requirements.

system checker

If installed on supported hardware, in most cases there will only be “soft” failures which can be fixed by clicking on “Auto-fix”:

system checker

Confirm the output now says system requirements are met and navigate to the interfaces page.

Network interfaces configuration

On the following page network interfaces can be viewed or configured. At this point only wired interfaces and PPPoE can be configured from flexiEdge Web UI while WiFi or LTE interfaces can be configured through flexiManage. The goal is to configure interfaces for internet connectivity so the device can be registered with flexiManage. Complete network configuration is done from flexiManage and not flexiEdge Web UI.


flexiWAN relies on netplan for interfaces configuration. It is recommended to configure WAN and LAN wired interfaces prior to adding the device to flexiManage for recovery purpuses. This way the device is reachable via configured interfaces even when flexiWAN is not running.


PPPoE configuration

flexiWAN supports PPPoE. PPPoE can only be configured and provisioned from the flexiEdge UI interfaces page. Simply click on the settings icon next to interface name which will open PPPoE configuraton page.


From the PPPoE configuration page enable the interface and enter the credentials from PPPoE provider and click save. Optionally set custom DNS.


Once PPPoE is configured, wait for a few moments until the page shows PPPoE connection established.



Please note that since PPPoE required to be provisioned before even connecting to flexiManage, it can only be provisioned from flexiEdgeUI. The configuration can be changed from flexiEdgeUI as long as the interface is not assigned in flexiManage. Detecting PPPoE provisioning may take a few moments.

VLAN configuration

VLAN’s are supported and can be added via flexiEdge. Unless required for internet connectivity, it’s recommended to add VLAN’s using flexiManage and not local flexiEdge UI. VLAN’s added using local edgeUI cannot be removed after the device is registered to flexiManage, because of this it is strongly advised to add VLAN’s using flexiManage whenever possible for easier management.

To configure VLAN’s, simply click on + sign from the Actions column.

vlan 1

Enter VLAN tag and confirm.

vlan 2

Added VLAN’s can be configured just as any interface.

vlan 2

After configuring network interfaces, follow the next steps to register device with flexiManage.

Device registration

Token creation

To register a device, first create your organization token. The organization token needs to be generated only once and is used for all the devices in a single organization. Having multiple tokens in single organization is also supported, where it introduces additional security in case of unauthorized physical access of device. From flexiManage, navigate to Inventory > Tokens and click on “New Token” button.

Create Token

Provide a token name and click “Add”. A new token will be created and presented in the Tokens page.

Token Created

Copy or download the token in order to add it locally on your device. Token can be added to the device in two ways:

  • connect to flexiEdge UI web interface

  • ssh or using direct console.

Adding the token through the flexiEdge UI

Open a browser and point it to the IP and port 8080 of currently active network interface on flexEdge device. Example:


After opening the flexiEdge UI page, enter username and password from Linux.


Navigate to Settings section and then enter the token copied from flexiManage. Click Update Token and after that continue to flexiManage Devices page to complete the device registration.

EdgeUI 2


Make sure to follow flexiEdge documentation and first run and pass system checker. Check flexiEdge UI to learn more.

Adding the token using SSH or console

For this step connect to a direct console or ssh connection to the device is required. Insert the token using text editor such as nano or vi:

nano /etc/flexiwan/agent/token.txt

Add token

Inserting the token is the final step where local EdgeUI or direct console / ssh connection to physical device are needed. Afterwards all management is done through flexiManage.

Registering a device

Once the token is added, the device will appear in the Inventory > Devices page as a new and unapproved device:

Unknown Device

Click on the newly appeared “Unknown” device name to open the device settings. Enter the device name and description, then approve it.

Update Device

Click on “Update Device” at any time to apply the latest configuration. Follow the next section to complete device configuration.