ifcfg-vlan - virtual LAN interface configuration



Virtual LANs (802.1q)

To setup a vlan interface you need a configuration file that contains at least the mandatory
 variable with the real interface used for the virtual LAN.

Further, it may contain the optional
 variable that specifies the VLAN ID.

By default and when the VLAN_ID variable is not set, the number at the end of the interface name is the VLAN ID.

Preferably the interface name and the configuration file follow the VLAN interface name scheme (type), that is either:


ifcfg-vlan<VLAN-ID> (e.g. ifcfg-vlan42)


ifcfg-name.<VLAN-ID> (e.g. ifcfg-eth0.42)

The VLAN-ID can be also 0-padded (e.g. ifcfg-vlan0042 or ifcfg-eth0.0042).

Also in case of custom names, trailing digits are interpreted as VLAN-ID by default (e.g. ifcfg-dmz42). When VLAN_ID is set in the config, the interface name have any name (e.g. ifcfg-foobar).

Note: The drawback of custom interface names and VLAN_ID usage is, that a rename of the interface is required and that they violate the name scheme.

The real interface will be set UP automatically and doesn’t need a config file in case of a physical interface. But without a config file YaST will consider this interface as unused, if will not follow hotplug events and you’re unable to apply any settings, e.g. ETHTOOL_OPTIONS. To avoid that, provide an config file with at least STARTMODE=’auto’.

The rest of the VLAN interface IP and routes configuration do not differ from ordinary interfaces. See also man ifcfg and man routes for details.


Sets up vlan3 vlan interface on top of eth0:

ifcfg-vlan3 STARTMODE=’auto’ ETHERDEVICE=’eth0’ IPADDR=’’

Sets up eth0.3 vlan interface on top of eth0:

ifcfg-eth0.3 STARTMODE=’auto’ ETHERDEVICE=’eth0’ IPADDR=’’

Sets up lan1 vlan interface with ID 42 on top of eth0:

ifcfg-lan1 STARTMODE=’auto’ ETHERDEVICE=’eth0’ VLAN_ID=’42’ IPADDR=’’


Please report bugs at <>


Christian Zoz <> Michal Svec <> Bjoern Jacke Mads Martin Joergensen <> Michal Ludvig <> Marius Tomaschewski <>


routes(5), ifcfg(5), ifup(8).

openSUSE Logo