wpa_supplicant.conf

File Location And Role

The file lives at /data/etc/wpa_supplicant.conf. It can be provisioned using /boot/wpa_supplicant.conf and uses /etc/wpa_supplicant.conf as a default. The file is not present by default and should be created by the user, if a WiFi connection is needed.

Similarly, a secondary Wi-Fi interface (indicated by OS_WLAN1) can be configured using /data/etc/wpa_supplicant1.conf, /boot/wpa_supplicant1.conf and /etc/wpa_supplicant1.conf, respectively.

File Format

The file is used as configuration for the wpa_supplicant daemon. Following is a common example of a wpa_supplicant.conf file that will connect to the network named mynet with network key mykey1234:

update_config=1
ctrl_interface=/var/run/wpa_supplicant

network={
    ssid="mynet"
    psk="mynet1234"
}

Initial Setup

When using the writeimage.sh, one could pass the -n ssid:psk option to the script to easily create an initial wireless configuration file on the boot partition.