https://github.com/rgryta/pi-hole-qei

Repository for automatically preparing Raspberry Pi OS Lite with firstboot setup for Pi-Hole and Unbound DNS
https://github.com/rgryta/pi-hole-qei

pi-hole pihole raspberry raspberry-pi raspberrypi unbound unbound-dns wsl wsl2

Last synced: 3 days ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/rgryta/pi-hole-qei
• Owner: rgryta
• License: mit
• Created: 2023-02-25T00:16:37.000Z (almost 2 years ago)
• Default Branch: main
• Last Pushed: 2023-03-03T16:35:36.000Z (almost 2 years ago)
• Last Synced: 2023-03-05T10:52:42.101Z (almost 2 years ago)
• Topics: pi-hole, pihole, raspberry, raspberry-pi, raspberrypi, unbound, unbound-dns, wsl, wsl2
• Language: Shell
• Homepage:
• Size: 10.7 KB
• Stars: 2
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# 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)

1. PIHOLE_HOST - hostname of the Raspberry Pi

1. PIHOLE_USER - name of pi user

1. 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.