Recipe: 005-Wifi

Recipe Card


005 : Wifi Configuration


Recipe Files Ingredients

See the markdown version of this recipe on the Pi-Kitchen GitHub site see:





WARNING: The following assumes that you have a working wired network (or a wireless adaptor which doesn’t need additional drivers).

Check out the Wifi driver recipe if you need help identifying the wifi adaptor or want to install the drivers without a working network connection.


Installing the wifi drivers, using

The script will allow the required wifi drivers to be installed during the first start up. The script should be placed in the _RUNONCE directory.

For each driver you want to install, where is the driver listed from searching apt-cache:

sudo apt-get install <packagename>

e.g. For firmware-ralink add the following to

sudo apt-get install firmware-ralink

Wifi Settings

The interfaces file

This replaces the standard etcnetworkinterfaces file with one which uses etcwpa.conf for the wifi settings.

auto lo

iface lo inet loopback

iface eth0 inet dhcp

iface default inet dhcp

auto wlan0

iface wlan0 inet dhcp

wpa-conf /etc/wpa.conf

NOTE: Some devices will have different names to wlan0 (i.e. ra0) so you may need to adjust this file.

The wpa.conf file

The wpa.conf file should detail the wifi settings as follows:











NOTE: We place this file in _SETTINGS so that it is easier to remove sensitive information from our configurations.

An example wpa.conf is provided in pi-kitchen005-wifietc directory.


How to use


1.Identify your Wifi adaptor.

2.Ensure will install the correct package for your device.

3.Insert your Wifi settings into the wpa.conf file.



The ingredient files should be placed in the following location on the NOOBS RECOVERY partition:




This recipe uses the following files:





Plus the following files in the _SETTINGS folder:

It is assumed that the following file(s) are placed in the following location on the NOOBS RECOVERY partition:




You will need the following _SETTINGS file(s):




NOTE: Files which are configured manually or may contain sensitive information are placed in the _SETTTINGS directory on the SD-Card. This is so that it is easier to support different configurations and remove sensitive information from the setup if needed.

Perform the following actions:


Ensure you update wpa.config with your own Wifi SSID and pass-phrase.


You can download all the ingredient files, and extracted directly to the NOOBS SD-Card (ensuring you remove the ZIP file’s name from the directory – the files should be extracted to pi-kitchen/005-wifi).

The Recipe Files

Each recipe will use one file for each of the partitions it installs to – boot, root and data).

You will need to suitably rename or copy the content of each of the following files into your recipe files (i.e. RaspbianPiKitchen_root.txt) and place them in your os folder in the NOOBS partition (i.e. os/Raspbian).

For more information see the Pi-Kitchen: Creating Flavours guide.



#Recipe: 005-wifi

#- Setup Wifi interfaces file

../../pi-kitchen/005-wifi/etc/network/interfaces /etc/network

#- Apply the user wifi SETTINGS

../../pi-kitchen/_SETTINGS/005-wifi/wifi_example/wpa.conf /etc

../../pi-kitchen/_SETTINGS/005-wifi/wifi_home/wpa.conf /etc

#-Install driver(s) for Wifi Adaptor(s)

../../pi-kitchen/005-wifi/_RUNONCE/ /home/pi/bin/_RUNONCE

Enjoy baking your Raspberry Pi SD-Card fresh from the Pi-Kitchen.


Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

This site uses Akismet to reduce spam. Learn how your comment data is processed.