Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
Note that the most recent documentation can he found here: https://docs.pi-hole.net
Pi-hole is easy to setup using our intelligent installer. Once you are set up, just use Pi-hole as your DNS server and ads will immediately be blocked--no additional client-side software needed!
1. Install a supported operating system
Pi-hole works on many Linux distros.
2. Install Pi-hole
Run the install command.
3. Use Pi-hole as your DNS server
Configure your router’s DHCP options to force clients to use Pi-hole as their DNS server, or manually configure each device to use the Pi-hole as their DNS server.
4. Block ads everywhere
Since Pi-hole works at the DNS level, ads can be blocked in non-traditional places such as ad-support mobile apps and smart TVs.