Version v1.12 of the documentation is for the Talos version being developed. For the latest stable version of Talos, see the latest version.

DummyLinkConfig

DummyLinkConfig is a config document to create a dummy (virtual) network link.
apiVersion: v1alpha1
kind: DummyLinkConfig
name: dummy1 # Name of the dummy link (interface).
# Configure addresses to be statically assigned to the link.
addresses:
    - address: 192.168.1.100/24 # IP address to be assigned to the link.

# # Override the hardware (MAC) address of the link.
# hardwareAddr: 2e:3c:4d:5e:6f:70
FieldTypeDescriptionValue(s)
namestringName of the dummy link (interface).
Show example(s)
name: dummy1
hardwareAddrHardwareAddrOverride the hardware (MAC) address of the link.
Show example(s)
hardwareAddr: 2e:3c:4d:5e:6f:70
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).
addresses[]AddressConfigConfigure addresses to be statically assigned to the link.
routes[]RouteConfigConfigure routes to be statically created via 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).
Show example(s)
address: 192.168.1.100/24
address: fd00::1/64
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.
Show example(s)
destination: 10.0.0.0/8
gatewayAddrThe route’s gateway (if empty, creates link scope route).
Show example(s)
gateway: 10.0.0.1
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.
Last modified September 18, 2025: feat: implement link configuration (7bae5b40b)