incus-mirror/doc/reference/network_macvlan.md

(network-macvlan)=

Macvlan network

Macvlan is a virtual {abbr}LAN (Local Area Network) that you can use if you want to assign several IP addresses to the same network interface, basically splitting up the network interface into several sub-interfaces with their own IP addresses. You can then assign IP addresses based on the randomly generated MAC addresses.

The macvlan network type allows to specify presets to use when connecting instances to a parent interface. In this case, the instance NICs can simply set the network option to the network they connect to without knowing any of the underlying configuration details.

If you are using a `macvlan` network, communication between the LXD host and the instances is not possible.
Both the host and the instances can talk to the gateway, but they cannot communicate directly.

(network-macvlan-options)=

Configuration options

The following configuration key namespaces are currently supported for the macvlan network type:

• user (free-form key/value for user metadata)

{{note_ip_addresses_CIDR}}

The following configuration options are available for the macvlan network type:

Key	Type	Condition	Default	Description
gvrp	bool	-	false	Register VLAN using GARP VLAN Registration Protocol
mtu	integer	-	-	The MTU of the new interface
parent	string	-	-	Parent interface to create macvlan NICs on
vlan	integer	-	-	The VLAN ID to attach to
user.*	string	-	-	User-provided free-form key/value pairs