Initial Setup

This section provides instructions for the initial setup process necessary to establish an internet connection for your flexiEdge device and register it with flexiManage. Once the device is successfully connected and registered with flexiManage, please proceed to the Device Configuration section.

Upon installation of flexiEdge or upon receiving a device pre-installed with flexiWAN, it is essential to perform the initial network configuration to enable connectivity to the internet and registration with flexiManage.

flexiEdge webUI

The primary purpose of the local flexiEdge UI is to facilitate seamless initial configuration and troubleshooting tasks. Once the initial configuration is complete, further device configuration is managed through flexiManage.

The flexiEdge UI is enabled by default on all wired interfaces, and it can be accessed by using the device’s IP address along with port 8080. Please note that access to the flexiEdge UI is contingent upon the presence of an active network interface on the device.

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 flexiEdge WebUI sidebar follows the post-installation configuration sequence:

  1. System Checker - Running the system checker verifies if the device meets the prerequisites for running flexiWAN.

  2. Interfaces - Configuring network interfaces to enable internet connectivity.

  3. Settings - Inputting the token establishes the connection between the device and the flexiManage account.”

Upon successfully completing all three steps, the device will be connected to your flexiManage account and will await approval.

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 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

Support for VLANs is available and they can be added through flexiEdge. However, unless VLANs are necessary for internet connectivity, it is recommended to add them using flexiManage rather than the local flexiEdge UI. Please note that VLANs added using the local edgeUI cannot be removed once the device is registered with flexiManage. Therefore, it is highly advisable to utilize flexiManage for adding VLANs whenever feasible, as it simplifies 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, begin by creating your organization’s token. The organization token requires generation only once and is applicable to all devices within a single organization. It’s worth noting that having multiple tokens within a single organization is also supported, enhancing security measures in the event of unauthorized physical access to a device. To create a token from flexiManage, go to Inventory > Tokens and select the “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.