Documentation

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

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

interfaces_file

Manage network interface configuration in /etc/network/interfaces.

Attributes

check_mode:
  support: full

Parameters

Parameter	Required	Type	Values	Description
address		string		The IP address for static configuration. Required if method=static.
auto		boolean		Whether the interface should be started at boot. [default: `true`]
dns_nameservers		array		List of DNS nameservers.
dns_search		array		List of DNS search domains.
family		string	inet inet6	The address family (inet for IPv4, inet6 for IPv6). [default: `"inet"`]
gateway		string		The default gateway for static configuration.
iface	true	string		The interface name (e.g., eth0, enp0s3, wlan0).
method		string	static dhcp manual loopback	The configuration method (static, dhcp, manual, etc.). [default: `"static"`]
netmask		string		The netmask for static configuration. Required if method=static.
path		string		Path to the interfaces file. [default: `"/etc/network/interfaces"`]
state		string	present absent	Whether the interface configuration should exist or not. [default: `"present"`]

Examples

- name: Configure static IP on eth0
  interfaces_file:
    iface: eth0
    address: 192.168.1.100
    netmask: 255.255.255.0
    gateway: 192.168.1.1
    dns_nameservers:
      - 8.8.8.8
      - 8.8.4.4

- name: Configure DHCP interface
  interfaces_file:
    iface: eth1
    method: dhcp

- name: Remove interface configuration
  interfaces_file:
    iface: eth2
    state: absent

- name: Configure interface without auto
  interfaces_file:
    iface: eth3
    method: static
    address: 10.0.0.100
    netmask: 255.255.255.0
    auto: false