Skip to main content
FieldTypeDescriptionValue(s)
namestringName of the vxlan link (interface) to be created.
iduint32VXLAN network identifier (VNI) to be used for the vxlan link.
localAddrSource IP address (IPv4 or IPv6) to use in outgoing packets for the tunnel endpoint.
groupAddrMulticast group IP address (IPv4 or IPv6) to join for the tunnel.
Either the group or the local address should be set, not both.
parentstringName of the parent link (interface) used as the physical device for the tunnel endpoint.
Link aliases can be used here as well.
portuint16Destination UDP port for VXLAN traffic.
If not set, defaults to 4789.
learningboolEnable learning of source link addresses (MAC learning).
If not set, defaults to true.
hardwareAddrHardwareAddrOverride the hardware (MAC) address of the link.
upboolBring the link up or down.

If not specified, the link will be brought up.
mtuuint32Configure LinkMTU (Maximum Transmission Unit) for the link.

If not specified, the system default LinkMTU will be used (usually 1500).
addressesAddressConfigConfigure addresses to be statically assigned to the link.
routesRouteConfigConfigure routes to be statically created via the link.
multicastboolSet the multicast capability of the link.

addresses[]

AddressConfig represents a network address configuration.
FieldTypeDescriptionValue(s)
addressPrefixIP address to be assigned to the link.

This field must include the network prefix length (e.g. /24 for IPv4, /64 for IPv6).
routePriorityuint32Configure the route priority (metric) for routes created for this address.

If not specified, the system default route priority will be used.

routes[]

RouteConfig represents a network route configuration.
FieldTypeDescriptionValue(s)
destinationPrefixThe route’s destination as an address prefix.

If not specified, a default route will be created for the address family of the gateway.
gatewayAddrThe route’s gateway (if empty, creates link scope route).
sourceAddrThe route’s source address (optional).
metricuint32The optional metric for the route.
mtuuint32The optional MTU for the route.
tableRoutingTableThe routing table to use for the route.

If not specified, the main routing table will be used.