Change WiFi credentials

Setup Wifi after your Printer moved or Wifi credentials changed.


Get a proper Texteditor like Visual Studio Code (vscode), Atom or Notepad++

Any other Editor with capability to set line endings to LF will do the Job also.

Do not use Windows Editor or WordPad, they will not work!

This applies to both methods! For a full list of region codes, please visit

The boot partition is the one, readable in Windows, formatted in FAT32.

Raspberry Pi OS based MainsailOS

This procedure is based on the original documentation of Raspberry Foundation. You will find the original description here.

Step 1

Open your Texteditor and create a new file called wpa_supplicant.conf

Step 2

Copy this section into the new file:

ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev
country=<Insert 2 letter ISO 3166-1 country code here>
# ap_scan=1 ## Uncomment if you wish, that wpa_supplicant handles AP Scan instead of HW Drivers

 # scan_ssid=1 ## Uncomment if your Wifi is hidden!
 ssid="<Name of your wireless LAN>"
 psk="<Password for your wireless LAN>"

Insert your country code, SSID and your password! Please see documentation of your network router to get SSID and password.

If you want to set up more than one Network, just copy the network block multiple times and don't forget to uncomment ap_scan and scan_ssid.

Small list of valid Country codes

  • GB (United Kingdom)

  • FR (France)

  • DE (Germany)

  • US (United States)

  • SE (Sweden)

Step 3

Please copy that newly created wpa_supplicant.conf file to the boot partition of your SD card.

Further Information

If you need to get further Information please visit

Armbian based MainsailOS

Step 1

Grab your SD Card from your SBC and insert into your SD Card reader.

Step 2

Copy the network_config.txt.template and rename that file to network_config.txt.

Step 3

Open network_config.txt with your Texteditor.

Step 4

Provide your Wifi credentials and setup your region code.

Please don't forget to set:


Finished 🎉

Now put the SD card in your SBC and wait for the Pi to come up.

Last updated