Pi-hole Wizard

Block ads on every device in your home. No apps to install, no browser extensions needed. Just run one command on your Raspberry Pi.

100% Free Open Source Works on Raspberry Pi No Technical Knowledge Required

Get Started in 60 Seconds

Open a terminal on your Raspberry Pi and paste this command:

curl -sSL https://pihole-wizard.com/install.sh | bash

This downloads and runs the Pi-hole Wizard. A web interface will open automatically.

How It Works

1

Run the Command on Your Pi

SSH into your Raspberry Pi or open a terminal. Paste the install command and press Enter. Don't have SSH set up? See below.

2

Open the Wizard in Your Browser

The installer will show you a URL (like http://192.168.1.x:8080). Open it on your phone, tablet, or computer - any device on your network.

3

Answer a Few Questions

The wizard asks simple questions about your network. It auto-detects most settings. Just click Next, Next, Install.

4

Point Your Router to Pi-hole

Change your router's DNS setting to your Pi's IP address. The wizard tells you exactly what to do. Every device on your network will now be ad-free!

What You Get

Network-Wide Ad Blocking

Blocks ads on phones, tablets, smart TVs, and every device - even apps without ad-blocker support.

Enhanced Privacy

Blocks trackers and telemetry. Uses Unbound for private DNS resolution - your queries never leave your network.

Faster Browsing

Pages load faster without ads. DNS caching speeds up frequently visited sites.

Easy Management

Beautiful web dashboard to whitelist sites, view statistics, and manage your Pi-hole.

What You Need

Raspberry Pi (3, 4, or 5)
microSD card (32GB recommended)
Raspberry Pi OS installed
Connected to your network
Internet connection

Don't have a Raspberry Pi?

Here's what we recommend:

Recommended Starter Kit Everything included - just plug in! Pi 5 Board Need your own accessories Budget Pi 4 Board Need your own accessories 32GB microSD Required for board-only options

As an Amazon Associate, we earn from qualifying purchases.

Support This Project

Pi-hole Wizard is free and open source. If it saves you time and frustration, consider supporting development!

Buy Me a Coffee GitHub Sponsors

Need Help? Ask AI

Get instant help with Pi-hole setup, troubleshooting, and configuration.

Get your free API key at console.anthropic.com. Your key stays in your browser.

Common Questions

How do I access my Raspberry Pi's terminal?

Option A - With a monitor: Connect a monitor and keyboard to your Pi, open the Terminal app.

Option B - From another computer (SSH): Open Terminal (Mac/Linux) or PowerShell (Windows) and type: ssh pi@raspberrypi.local. Default password is "raspberry".

What if I don't know my Pi's IP address?

The wizard auto-detects it! Or check your router's admin page for connected devices, or run hostname -I on your Pi.

Will this break my internet?

No. If something goes wrong, just change your router's DNS back to automatic. The wizard also validates everything before making changes.

Is this really free?

Yes! Pi-hole is open source, and this wizard is too. If it saves you time, consider buying me a coffee.

Can I use something other than a Raspberry Pi?

Yes! Any Linux machine or Docker-capable system works. The wizard supports Docker and bare-metal installs.

How do I uninstall?

Run this command on your Pi: curl -sSL pihole-wizard.com/install.sh | bash -s -- --uninstall

Where can I learn more about Pi-hole?

Check out the official Pi-hole Documentation, the GitHub repo, or join the community forum for help and discussions.