h3xx/you-dont-need-pihole
1
0
Fork 0
mirror of https://codeberg.org/h3xx/you-dont-need-pihole.git synced 2026-06-14 17:55:39 +00:00
Code Issues Wiki Activity
Network-wide DNS blocking without extra hardware.
45 commits 1 branch 2 tags 154 KiB
  • Perl 75.3%
  • Shell 24.7%
Find a file
Exact
Dan Church 266c1bae37
 Update instructions
2025-05-07 12:56:52 -05:00
allowlists Add support for allowlists 2022-11-25 16:17:54 -06:00
dev-t CI: Add test for changelog formatting 2025-02-26 15:41:29 -06:00
dnsmasq.d Add suggested 'bogus-priv', 'domain-needed' options 2022-12-13 11:51:03 -06:00
lists Clear custom ad domains list 2022-12-14 10:22:20 -06:00
repos Fix AdroitAdorKhan-EnergizedProtection 2022-12-08 14:25:01 -06:00
repos-noupdates Fix AdroitAdorKhan-EnergizedProtection 2022-12-08 14:25:01 -06:00
util CI: Add test for changelog formatting 2025-02-26 15:41:29 -06:00
.editorconfig Add README, CONTRIBUTING, LICENSE 2022-11-11 16:59:14 -06:00
.gitignore Update gitignore 2022-11-12 11:27:01 -06:00
.gitmodules Fix AdroitAdorKhan-EnergizedProtection 2022-12-08 14:25:01 -06:00
CHANGELOG.md Update changelog 2025-02-26 15:34:11 -06:00
CONTRIBUTING.md Add README, CONTRIBUTING, LICENSE 2022-11-11 16:59:14 -06:00
custom.list Initial commit 2022-11-11 16:47:36 -06:00
LICENSE-commons-clause.md Add README, CONTRIBUTING, LICENSE 2022-11-11 16:59:14 -06:00
LICENSE.md Add README, CONTRIBUTING, LICENSE 2022-11-11 16:59:14 -06:00
local.list Initial commit 2022-11-11 16:47:36 -06:00
make-block.pl Fix style issues (PBP) 2025-03-17 12:14:46 -05:00
README.md Update instructions 2025-05-07 12:56:52 -05:00
update.cfg.example Replace Slackware-specific dnsmasq restart 2022-11-12 12:01:03 -06:00
update.sh Remove unused variable 2023-07-11 12:55:25 -05:00

README.md

You Don't Need Pi-hole

Network-wide DNS blocking without extra hardware.

This project implements the ad-blocking functionality of a Pi-hole without needing any extra hardware. All you need is a Linux computer on your network. This might also work with a Mac OSX computer, but I haven't tested it.

A Pi-hole is a Raspberry Pi based "black hole" for Internet advertisements. It works by intercepting and answering DNS queries for a list of known advertisement servers.

This project instead uses dnsmasq running on an existing server to answer DNS queries.

How to Install

You'll need dnsmasq installed for this.

  1. Clone the project:
git clone --recursive https://codeberg.org/h3xx/you-dont-need-pihole.git /etc/you-dont-need-pihole
  1. Run update.sh to generate the initial blocklist:
/etc/you-dont-need-pihole/update.sh

Important

If you didn't use /etc/you-dont-need-pihole as the installation directory, update dnsmasq.d/01-you-dont-need-pihole.conf, replacing /etc/you-dont-need-pihole with wherever the root of this project is installed to.

  1. Add You Don't Need Pi Hole's dnsmasq.d configuration directory path to dnsmasq.conf:
echo 'conf-dir=/etc/you-dont-need-pihole/dnsmasq.d' >> /etc/dnsmasq.conf

You can also copy or symlink dnsmasq.d/01-you-dont-need-pihole.conf if you need the config to live somewhere else.

  1. Restart the dnsmasq service:
# Debian & Ubuntu, RedHat & CentOS
service dnsmasq restart
  1. Make sure 53/udp is unfirewalled:
# Debian & Ubuntu, RedHat & CentOS
sudo firewall-cmd --add-port=53/udp --permanent

  1. Go into your router settings and change the DNS IP address provided via your router's DHCP responses to be your server's (i.e. the one with You Don't Need Pi Hole) local IP address. See this thread for a walkthrough.

  2. Recommended: If you use the You Don't Need Pi Hole machine as a general computer, configure it to use the local dnsmasq daemon for client DNS queries. This is a good idea because it may save some network traffic depending on how your router works. Worst case scenario, it'll do nothing.

If your OS uses dhcpcd for network configuration (Slackware), you can add this line to your /etc/dhcpcd.conf:

static domain_name_servers=127.0.0.1

License

Copyright (C) 2021-2022 Dan Church.

License GPLv3: GNU GPL version 3.0 (https://www.gnu.org/licenses/gpl-3.0.html)

with Commons Clause 1.0 (https://commonsclause.com/).

This is free software: you are free to change and redistribute it.

There is NO WARRANTY, to the extent permitted by law.

You may NOT use this software for commercial purposes.