1. Home
  2. Help Topics
  3. VLAN and Network Interface Configuration

VLAN and Network Interface Configuration

IMPORTANT: The Domotz Agent (software) automatically scans all the VLANs configured as Network Interfaces on the hardware hosting the Agent itself.

Configuring VLANs, via Network Interfaces, is possible on all the hardware, and the Domotz Agent will automatically scan on all the configured Network Interfaces, regardless of the hardware used to host the Domotz Agent.

However, since Domotz owns the network stack of the Domotz Box, and it can control it, the configuration of VLANs is simplified and possible through the Web Interface of the Domotz Agent itself when using the Domotz Box.

Note: Configuring VLANs is recommended against “Configuring Routed Subnet Scan” since it provides additional information and benefits.

For a few examples of configurations on the usage of Routed Subnets (Routed Networks) vs the usage of VLANs (Attached Networks), please refer to Monitoring networks with subnets and VLANs blog post.

Multiple VLANs

In order to allow Domotz to discover and monitor devices on two or more VLANs, the user should configure both the Hardware hosting the Domotz Agent with multiple Network Interfaces and the switch connecting it.

The configuration of the VLANs as Network Interfaces is a prerequisite to allow the Domotz Agent to automatically scan across all the available VLANs.

Every hardware and operating system has its own way of configuring VLANs as Network Interfaces.

For example, the following resources provide examples of how to configure VLANs on the following hardware capable of hosting Domotz Agent:

Please, contact support@domotz.com if you are not sure how to create Network Interfaces to access VLANs on your specific hardware.

The following section also shows how to configure the VLANs support on the Domotz Box.

Switch Configuration

The interface port of the switch which will be used to connect the Domotz Box, should be in Trunk mode:

  • Native / Untagged for the main interface used by the Domotz Box to communicate with the gateway (e.g. eth0).
  • Tagged for the additional VLANS to be monitored (e.g. the eth0.10 used for lan 10).
Cisco example:

switch#configure terminal
switch(config)#interface ethernet 0/23
switch(config)#description DomotzBox
switch(config-if)#switchport mode trunk
switch(config-if)#switchport trunk encapsulation dot1q
switch(config-if)#switchport trunk native vlan 4

Domotz Agent Configuration on Domotz Box

The Domotz Box can also be configured to allow the Domotz Agent to scan across multiple VLANs.

In order to allow the Domotz Box to configure multiple Network Interfaces on two or more VLANs connect directly to the HTTP service running on port 3000 (http://:3000) and click the Config button next to Vlan under the Network Info section. It is not necessary to restart the Agent.

You can find all the necessary information for configuring the Domotz Box to monitor multiple VLANs or to configure the Domotz Box with a Static IP in the Network Info section of the HTTP portal.

Network Info:

VLAN and Network Interface Configuration screenshot 1

When you press the Edit button you will see:

VLAN and Network Interface Configuration screenshot 2

Switching the DHCP toggle to Off you will be allowed to specify Static IP and non-DHCP based subnet mask, Gateway and DNS servers.

When pressing the VLAN Config button you will see the following screen which will assist you in this configuration.

VLAN and Network Interface Configuration screenshot 3

For every VLAN that you want to add, you need to specify:

  • the Identification number of the additional VLAN.
  • the Static IP address of the Network Interface of the Domotz Box on the additional VLAN.
  • the subnet mask on the additional VLAN.

Make sure that the IP Address on the additional VLAN is not in use, and it is not the *.*.*.0 of that subnet (e.g. do NOT use IP addresses like

Devices discovered on the tagged VLANs cannot be blocked/paused through Violet – Customer Facing App (Violet Digital Support Client App) due to technical limitations to the implementation of the pausing functionality. Domotz recommends configuring the Domotz Box on the same subnet as a primary interface where devices that might be blocked through the Violet Digital Support Client App are expected to be.

Updated on October 21, 2022

Was this article helpful?