Join GitHub today
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.