VXLAN Configuration Example

VXLAN support has been introduced starting with firmware version 00.07.09 and later. It is advised to update to the latest firmware available.

The information in this page is updated in accordance with 00.07.09.1 firmware version.

Introduction

VXLAN (Virtual Extensible LAN) encapsulates Layer 2 Ethernet frames within Layer 3 packets, creating a Layer 2 network over a Layer 3 infrastructure. It acts as a virtual switch, interconnecting routers and all devices connected to them into an extended Layer 2 network, enhancing scalability and flexibility. In this article several methods to configure a VXLAN tunnel between two Teltonika devices will be demonstrated.

Prerequisites

• Two routers with installed VXLAN packages, will refer to these as RUT1 and RUT2
• End device like Laptop or Mobile Phone
• Two Public IP addresses for configuring VXLAN over the Mobile network
• One Public IP address for configuring VXLAN over the VPN tunnel

VXLAN package Installation

First, install the VXLAN package on both RUT1 and RUT2 devices. This package is available on firmware version 07.09 and later, therefore, updating the router's firmware is a mandatory step if it is outdated. After the update, the package can be found in the Package Manager in the WebUI.

Navigate to System > Package Manager

1. In the search bar look for vxlan packet
2. Click Install

VXLAN over Wired WAN

In this section, the setup of VXLAN over Wired WAN using RUT1 and RUT2 devices will be described. The process will show how to create a VXLAN tunnel to connect the devices and allow them to communicate over the wired network.

Configuration on RUT1 device

---

Navigate to the Network > WAN section in the WebUI, then click the button for the wired WAN interface.

Configuration window will open. Adjust following:

1. Ensure interface is Enabled
2. Change Protocol to Static
3. Enter Ipv4 address for communication in this Wired WAN network
4. Select your preferable IPv4 netmask
5. Click twice

Navigate to the Network > Devices

1. In Add new device section select Type VXLAN
2. Press

3. Enter name of the new VXLAN interface
4. Enter the Remote address corresponding to RUT2 wired WAN interface IP address
5. Click twice

Navigate to Network > LAN and click to modify existing LAN interface

1. Asure that Bridge interfaces option is enabled
2. Click on the droplist and add vxlan1 interface
3. Click twice

Configuration on RUT2 device

---

The configuration steps for RUT2 are similar to those performed on RUT1, with some additional adjustments. Navigate to the Network > WAN section in the WebUI, then click the button for the wired WAN interface.

Configuration window will open. Adjust following:

1. Ensure interface is Enabled
2. Change Protocol to Static
3. Enter Ipv4 address for communication in this Wired WAN network
4. Select your preferable IPv4 netmask
5. Click twice

Navigate to the Network > Devices

1. In Add new device section select Type VXLAN
2. Press

3. Enter name of the new VXLAN interface
4. Enter the Remote address corresponding to RUT1 wired WAN interface IP address
5. Click twice

Navigate to Network > LAN and click to modify existing LAN interface.

1. For testing purposes, both routers should be part of the same LAN segment, so assign unique IP addresses to prevent conflicts.
2. Additionally, only one DHCP server, so disable DHCP on RUT2.

3. Asure that Bridge interfaces option is enabled
4. Click on the droplist and add vxlan1 interface
5. Click twice

VXLAN over Mobile network

In this section, VXLAN will be set up between two Teltonika devices using Mobile WAN, requiring two public IPs—one for each RUT device. The configuration steps will be similar to those described in the VXLAN over Wired WAN section of this page, except for the APN settings and the Network > Devices section settings, where the remote address of the created VXLAN interface will be updated to reflect the other router's public IP.

Configuration on RUT1 device

---

Navigate to the Network > WAN section in the WebUI, then click the Edit button for the mobile WAN interface.

Configuration window will open. Adjust the following:

1. Disable Auto APN
2. Select an APN that will provide your router with a public IP
3. Click twice

Navigate to Network > Devices. To create a new instance, click the button. If editing an existing interface from the previous configuration, click Edit

1. In Remote address section enter RUT2 Public IP address
2. Click twice

Configuration on RUT2 device

---

Navigate to the Network > WAN section in the WebUI, then click the Edit button for the mobile WAN interface.

Configuration window will open. Adjust following:

1. Disable Auto APN
2. Select an APN that will provide your router with a public IP
3. Click twice

Navigate to Network > Devices. To create a new instance, click the button. If editing an existing interface from the previous configuration, click Edit

1. In Remote address section enter RUT1 Public IP address
2. Click twice

VXLAN over VPN tunnel

File:Vxlan over vpn add server.png If only one public IP address is available, VXLAN can be configured through a VPN tunnel. In this case, an IPsec VPN will be used, where RUT1 acts as the VPN server and RUT2 as the client. The VPN creates remote tunnel endpoints, which can then be integrated into the VXLAN configuration to enable Layer 2 communication between the routers.

Configuration on RUT1 device

---

Navigate to Services > VPN > IPsec:

1. Enter Instance name
2. Click on the

3. Enable instance
4. Since RUT1 will serve as the server device, the Remote endpoint field should be left blank
5. Select Pre-Shared Key as the authentication method
6. Enter the key. This key must match the one that will be entered later in the RUT2 IPSec settings
7. Enter the RUT1 LAN IP address as the Local identifier
8. Enter the RUT2 LAN IP address as the Remote identifier

Scroll down to Connection settings:

9. Select "Start" in Mode section
10. Select "Tunnel" as connection type
11. Enable "Route based IPSec"
12. Enter the IP address of the RUT1 tunnel endpoint
13. Enter lower MTU to reduce packet size (optional)
14. Leave all other settings at their default values and click the twice

Navigate to Network > Devices. To create a new instance, click the button. If editing an existing interface from the previous configuration, click Edit

1. Enter IP address of RUT2 VPN tunnel endpoint
2. Click the twice

Configuration on RUT2 device

---

1. Enter Instance name
2. Click on the

Configuration testing

The best way to test the configuration after setting up VXLAN between the routers is to ping between devices on either side of the routers using their LAN IPs and check the ARP tables. This ensures that devices on the same LAN segment can communicate over the Layer 2 (L2) network through the routers.

Configuration testing from RUT1 side:

If the MAC address for the specified IP address in the ARP table matches the RUT2's MAC address, it confirms that the configuration is functioning correctly.

Configuration testing from RUT2 side: