Beam
Network
Configure VLAN Interfaces

Configure VLAN Interfaces

You can use the nmcli command-line tool to manage VLAN (Virtual LAN) interfaces on your Beam device. VLANs allow you to segment your network, isolating traffic into different broadcast domains on the same physical network infrastructure.

These instructions show how to add and remove a VLAN interface from the command line.

Run these commands using SSH or directly on the terminal.

Add a VLAN interface

Create the VLAN interface

This command creates a new VLAN interface. You need to specify a connection name, an interface name, the VLAN ID, and the parent physical device.

  • con-name: A descriptive name for the connection (e.g., vlan10).
  • ifname: The name for the new VLAN interface (e.g., eth0.10).
  • id: The VLAN tag number (e.g., 10).
  • dev: The parent physical interface (e.g., eth0).

For example, to create a VLAN with ID 10 on the eth0 interface:

sudo nmcli connection add type vlan con-name vlan10 ifname eth0.10 id 10 dev eth0

Configure the IP address

The IP address for VLAN interfaces can be configured from the UI in Beam 1.9 and later. See Configure network interfaces.

After creating the VLAN interface, you can configure its IP address, either via DHCP or by assigning a static IP.

  • To use DHCP:
    sudo nmcli connection modify vlan10 ipv4.method auto
  • To assign a static IP address:
    sudo nmcli connection modify vlan10 ipv4.addresses 192.168.10.50/24 ipv4.gateway 192.168.10.1 ipv4.method manual

Configure the firewall zone

The firewall zone for VLAN interfaces can be configured from the UI in Beam 1.9 and later. See Configure network interfaces.

  • For VLANs on a management port, set the firewall zone to control:
    sudo nmcli connection modify vlan10 connection.zone control
  • For VLANs on a data port, set the firewall zone to data:
    sudo nmcli connection modify vlan10 connection.zone data

Activate the interface

Bring the new VLAN connection up.

sudo nmcli connection up vlan10

Delete a VLAN interface

To remove a VLAN interface, you can delete its nmcli connection. This removes the VLAN interface and its configuration.

sudo nmcli connection delete vlan10