ansible-wifi

This is a simple Ansible role that helps you install and set up wpa_supplicant on Debian-based systems.

Requirements

• You need a user with sudo permissions.

Install the Role Using Ansible Galaxy

To install the role, run this command:

$ ansible-galaxy install layereight.wifi

If you want to install a specific version along with other roles, you can use a role file:

$ ansible-galaxy install -r roles.yml

roles.yml

- name: layereight.wifi
  src: layereight.wifi
  version: "1.3.0"

You can also check the Ansible Galaxy documentation and the Ansible Galaxy introduction.

Role Variables

Required Variables

• wifi_ssid: The name of your Wifi network.

• wifi_psk: The password for your Wifi network.

Optional Variables

• wifi_country

  • Default: "DE"
  • Description: Country code for the country where the wifi device is being used.

• wifi_control_interface_access_group

  • Default: root
  • Description: This allows non-root users to use the control interface. Check wpa_supplicant for more info.

• wifi_apt_cache_valid_time

  • Default: 86400
  • Description: Time in seconds that the APT cache is valid.

• wifi_rfkill_unblock

  • Default: true
  • Description: Unblocks the wifi interface using rfkill when set to true.

• wifi_disable_dhcpcd_workaround

  • Default: false
  • Description: If true, this will disable dhcpcd for the specified wifi_disable_dhcpcd_workaround_interface and the wpa_supplicant hook.

• wifi_disable_dhcpcd_workaround_interface

  • Default: wlan0
  • Description: The network interface that the wifi_disable_dhcpcd_workaround applies to.

Example Playbook

To run a typical playbook, use:

$ ansible-playbook -i inventory wifi.yml

inventory

[wifihosts]
myhost ansible_host=192.168.0.101 ansible_user=myuser ansible_ssh_pass=password 

wifi.yml

- hosts: wifihosts
  
  roles:
    - layereight.wifi
  
  vars:
    wifi_ssid: "my_wifi_name"
    wifi_psk: "my_wifi_password"