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

LinkConfig

LinkConfig is a config document to configure physical interfaces (network links).
apiVersion: v1alpha1
kind: LinkConfig
name: enp0s2 # Name of the link (interface).
up: true # Bring the link up or down.
mtu: 9000 # Configure LinkMTU (Maximum Transmission Unit) for the link.
# Configure addresses to be statically assigned to the link.
addresses:
    - address: 192.168.1.100/24 # IP address to be assigned to the link.
    - address: fd00::1/64 # IP address to be assigned to the link.
# Configure routes to be statically created via the link.
routes:
    - destination: 10.0.0.0/8 # The route's destination as an address prefix.
      gateway: 10.0.0.1 # The route's gateway (if empty, creates link scope route).
    - gateway: fe80::1 # The route's gateway (if empty, creates link scope route).

      # # The route's destination as an address prefix.
      # destination: 10.0.0.0/8
FieldTypeDescriptionValue(s)
namestringName of the link (interface).
Show example(s)
name: enp0s2
name: eth1
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)