Pi-hole/pi-hole
Pi-hole/pi-hole
1
0
Fork 0
mirror of https://github.com/pi-hole/pi-hole.git synced 2024-11-15 02:42:58 +00:00
Code Issues Projects Releases Packages Wiki Activity
A black hole for Internet advertisements
97 commits 8 branches 109 tags 27 MiB
Shell 83.8%
Python 12.4%
Roff 2.5%
Dockerfile 1.3%
Find a file
jacobsalmela e6b17ae8e9 Removing IPv6 support for now 
I'm not fully up on my IPv6, and using the loopback doesn't work for
clients anyway as described in the latest commit to gravity.sh
2015-06-13 22:02:17 -05:00
advanced Removing IPv6 support for now 2015-06-13 22:02:17 -05:00
gravity.sh Ditching the use of the loopback 2015-06-13 22:01:12 -05:00
LICENSE Initial commit 2014-06-08 10:02:55 -05:00
README.md featured on tech blogs 2015-03-27 19:20:39 -05:00

README.md

Raspberry Pi Ad Blocker

A black hole for ads, hence Pi-hole

Pi-hole

The Pi-hole is a DNS/Web server that will block ads for any device.

Coverage

Featured on MakeUseOf and Lifehacker!

Automated Install

On a clean installation of Raspbian, you can run this command to auto-install the Pi-hole. Once installed, configure any device to use the Raspberry Pi as your DNS server and the ads will be blocked.

curl -s "https://raw.githubusercontent.com/jacobsalmela/pi-hole/master/automated%20install/basic-install.sh" | bash

Gravity

The gravity-adv.sh does most of the magic. The script pulls in ad domains from many sources and compiles them into a single list of over 120,000 entries.

Whitelist and blacklist

You can add a whitelist or blacklist in /etc/pihole/ and the script will apply those files automatically.

Other Operating Systems

This script will work for other UNIX-like systems with some slight modifications. As long as you can install dnsmasq and a Webserver, it should work OK. The automated install only works for a clean install of Raspiban right now since that is how the project originated.

Optimizations

I am working on some great optimizations to allow the script to run much faster. I also have a bunch of new sources for ad domains but I still need to see if the lists are OK.