Network-wide ad blocking via your own Linux hardware
The Pi-hole® is a DNS sinkhole that protects your devices from unwanted content, without installing any client-side software.
This repo is the source for the official Pi-hole documentation.
To add a new link on the navigation panel you need to edit the mkdocs.yml
file in the root of the repo. There is a guide for building the navbar on the mkdocs wiki
To add a new document or guide.
docs/guides
docs/guides/url-friendly.md
When working on this repo, it is advised that you review your changes locally before committing them. The mkdocs serve
command can be used to live preview your changes (as you type) on your local machine.
Please make sure you fork the repo and change the clone URL in the example below for your fork:
Linux Mint / Ubuntu 18.04 LTS / 19.10 / 20.04 LTS:
git clone https://github.com/YOUR-USERNAME/docs
cd docs
sudo apt install python3-pip
pip3 install -r requirements.txt
mkdocs serve --dev-addr 0.0.0.0:8000
Fedora Linux instructions (tested on Fedora Linux 28):
git clone https://github.com/YOUR-USERNAME/docs
cd docs
pip install --user -r requirements.txt
mkdocs serve --dev-addr 0.0.0.0:8000
Docker instructions:
docker run -v `pwd`:/opt/app/ -w /opt/app/ -p 8000:8000 -it nikolaik/python-nodejs:python3.7-nodejs16 \
sh -c "pip install --user -r requirements.txt && \
/root/.local/bin/mkdocs build && \
npm ci && \
npm test && \
/root/.local/bin/mkdocs serve --dev-addr 0.0.0.0:8000"
After these commands, the current branch is accessible through your favorite browser at http://localhost:8000