Documentation

PLEASE NOTE: This document applies to latest version and not to the latest stable release v2.20

Documentation for other releases can be found by using the version selector in the top right of any doc page.

networkd

Manage systemd-networkd configuration files (.network, .link, .netdev).

Attributes

check_mode:
  support: full

Parameters

Parameter	Required	Type	Values	Description
addresses		array		IP addresses for the interface.
backup		boolean		Create backup of existing config file.
config		string		Raw INI content to use instead of generated config.
dhcp		boolean		Enable DHCP (ipv4, ipv6, true, false). [default: `false`]
directory		string		Path to the systemd-networkd configuration directory. [default: `"/etc/systemd/network"`]
dns		array		DNS servers.
gateway		string		Default gateway.
interfaces		array		Interface names to match.
mtu		integer		MTU for the link.
name	true	string		Name of the configuration file (without extension).
netdev_kind		string	bridge bond vlan macvlan ipvlan vxlan tun tap wireguard dummy	Netdev kind (bridge, bond, vlan, etc.).
restart		boolean		Restart systemd-networkd after changes. [default: `true`]
state		string	present absent	Whether the configuration should exist or not. [default: `"present"`]
type	true	string	network link netdev	Type of configuration: network, link, or netdev.
vlan_id		integer		VLAN ID (for netdev type vlan).

Examples

- name: Configure static IP on eth0
  networkd:
    name: 10-eth0
    type: network
    state: present
    interfaces:
      - eth0
    addresses:
      - 192.168.1.100/24
    gateway: 192.168.1.1
    dns:
      - 8.8.8.8
      - 8.8.4.4

- name: Configure DHCP on eth0
  networkd:
    name: 20-dhcp
    type: network
    state: present
    interfaces:
      - eth0
    dhcp: true

- name: Create bridge netdev
  networkd:
    name: br0
    type: netdev
    state: present
    netdev_kind: bridge

- name: Create bond netdev
  networkd:
    name: bond0
    type: netdev
    state: present
    netdev_kind: bond

- name: Configure VLAN netdev
  networkd:
    name: vlan10
    type: netdev
    state: present
    netdev_kind: vlan
    vlan_id: 10

- name: Configure link MTU
  networkd:
    name: 10-eth0
    type: link
    state: present
    interfaces:
      - eth0
    mtu: 9000

- name: Remove network configuration
  networkd:
    name: 10-eth0
    type: network
    state: absent