Pi-hole/pi-hole
Pi-hole/pi-hole
1
0
Fork 0
mirror of https://github.com/pi-hole/pi-hole.git synced 2024-12-23 21:30:17 +00:00
Code Issues Projects Releases Packages Wiki Activity
A black hole for Internet advertisements
98 commits 11 branches 109 tags 28 MiB
Shell 83.8%
Python 12.4%
Roff 2.5%
Dockerfile 1.3%
Find a file
jacobsalmela 9d5a7531ca Testing script for a mini LCD 
This script is for use with an Adafruit LCD so that you can peek at the
domains as they are blocked in real time.  It's not necessary for the
Pi-hole to function, but something fun I am working on.  There will be
a video in the next article I post.
2015-06-13 22:04:30 -05:00
advanced Testing script for a mini LCD 2015-06-13 22:04:30 -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.