Skip to content

Latest commit

 

History

History
28 lines (17 loc) · 1.24 KB

README.md

File metadata and controls

28 lines (17 loc) · 1.24 KB

Pi-hole QEI (Quick and Easy Install)

Repository for automatically preparing Raspberry Pi OS Lite with firstboot setup for Pi-Hole and Unbound DNS.

Supports both: Windows (with WSL) and Unix systems.

How to use

Modify

In root directory there's a file called prep_img_args. Modify provided arguments accordingly to your needs.

  1. PIHOLE_IP - static IP of your choosing (check arp -a to see which IP addresses in your network are already taken - requires net-tools on Unix systems)
  2. PIHOLE_HOST - hostname of the Raspberry Pi
  3. PIHOLE_USER - name of pi user
  4. PIHOLE_PASS - password for pi user

Run

On Windows simply launch prep_wsl.bat - you will be asked to run the scripts as administrator - this is to make sure that Hyper-V and WSL are installed and enabled.

On Linux you have to launch sudo prep_wsl.sh. Make sure you have all required packages: sudo curl xz file openssl, as well as sudo access.

Install

After scripts are executed, you will have a file called Image.img located in the root directory of this project. Use Etcher, Raspberry Pi Imager or dd.

Important

Keep in mind that if you plan on using Raspberry Pi Imager - DO NOT use advanced settings as they will overwrite firstboot script that sets everything up.