interfaces-wifi - WiFi vocabulary for the interfaces(5) file format

Ariadne Conill <ariadne@dereferenced.org> 2025-03-25 interfaces-wifi(5)

Wi-Fi (the IEEE 802.11 family of protocols) is a commonly used wireless networking standard. The following options allow for configuration of Wi-Fi client interfaces. WPA-secured networks are managed using wpa_supplicant(8), while insecure networks are managed directly with iwconfig(8).

A typical setup may involve connecting to a home and work network. To achieve this, we can define a pair of virtual interfaces called wifi-home and wifi-work, which connect to their respective wifi networks: iface wifi-home use dhcp wifi-ssid HomeNetwork wifi-psk ExamplePassphrase iface wifi-work use dhcp wifi-config-path /etc/network/wpa-work.conf The virtual interfaces can be used with ifup and ifdown: # ifup wlan0=wifi-home # ifdown wlan0 # ifup wlan0=wifi-work

interfaces-wifi - WiFi vocabulary for the interfaces(5) file format

iwconfig(8) wpa_supplicant(8)

wifi-config-pathpath Denotes the absolute path to a wpa_supplicant configuration file. If no path is given, /run/wpa_supplicant.<interface>.conf will be used for a temporary configuration file. This option may not be used with other configuration options. wifi-ssidssid The SSID the Wi-Fi client should connect to. wifi-pskpsk The passphrase for connecting to the Wi-Fi network. If unset, the client will connect without WPA2 encryption.