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-24 07:03:43 +00:00
Code Issues Projects Releases Packages Wiki Activity
A black hole for Internet advertisements
82 commits 8 branches 109 tags 27 MiB
Shell 83.8%
Python 12.4%
Roff 2.5%
Dockerfile 1.3%
Find a file
Robert Vineyard 3cee5d2e64 Added black.mp4 (1 second of black screen 720p video in mp4 format)
2015-03-24 20:46:37 -04:00
advanced Add 1x1 pixel Transparent GIF as 404 redirect 2015-03-23 11:48:33 -04:00
automated install Update basic-install.sh 2015-03-23 11:46:54 -04:00
block hulu ads Added black.mp4 (1 second of black screen 720p video in mp4 format) 2015-03-24 20:46:37 -04:00
dnsmasq.conf Update dnsmasq.conf 2014-10-11 12:58:30 -05:00
gravity-adv.sh Fixes #6 whitelist not found when using sudo 2015-03-10 12:27:57 -05:00
gravity.sh initial commit 2014-09-26 09:28:44 -05:00
index.html index for original pi-hole 2014-11-18 13:10:49 -06:00
LICENSE Initial commit 2014-06-08 10:02:55 -05:00
lighttpd.conf Add 404 redirect to 1x1 Transparent GIF 2015-03-23 11:43:30 -04:00
pihole.png 1x1 png for ads instead of blank space 2015-02-18 08:25:31 -06:00
README.md Giving the README some much needed love 2015-03-20 12:50:49 -05:00
resolv.conf Update resolv.conf 2014-10-11 13:23:44 -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.

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.