From 0a5286832d18b7be8a441a4db3c2586dc42350dd Mon Sep 17 00:00:00 2001
From: d4rklynk <74207682+d4rklynk@users.noreply.github.com>
Date: Tue, 24 May 2022 20:41:27 +0000
Subject: [PATCH] Add Pi-hole (#1314)

Signed-off-by: Daniel Gray <dng@disroot.org>
---
 docs/assets/img/dns/pi-hole.svg |  1 +
 docs/dns.en.md                  | 18 ++++++++++++++++++
 docs/tools.en.md                | 24 ++++++++++++++++++++++++
 3 files changed, 43 insertions(+)
 create mode 100644 docs/assets/img/dns/pi-hole.svg

diff --git a/docs/assets/img/dns/pi-hole.svg b/docs/assets/img/dns/pi-hole.svg
new file mode 100644
index 00000000..6424454c
--- /dev/null
+++ b/docs/assets/img/dns/pi-hole.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 89 130"><defs><linearGradient id="a" x1="0%" x2="100%" y1="49.975%" y2="49.975%"><stop offset="0%" stop-color="#12B212"/><stop offset="100%" stop-color="#0F0"/></linearGradient></defs><g fill="none" fill-rule="nonzero"><path fill="url(#a)" d="M36.56 39.93C20.34 38.2 4 25.94 2.71 0c25.17 0 38.63 14.9 39.93 38.51 4.76-28.32 27.07-25 27.07-25 1.06 16.05-12.12 25.78-27.07 26.59-4.2-8.85-29.36-30.56-29.36-30.56a.07.07 0 0 0-.11.08s24.28 21.15 23.39 30.31"/><path fill="#980200" d="M44.16 129.93c-1.57-.09-16.22-.65-17.11-17.11-.72-10 7.18-17.37 7.18-27.08C32.44 61.53 0 64.53 0 85.74a19.94 19.94 0 0 0 5.83 14.14L30 124.06a19.94 19.94 0 0 0 14.14 5.83"/><path fill="red" d="M88.32 85.75c-.09 1.57-.65 16.22-17.11 17.11-10 .72-17.38-7.18-27.08-7.18-24.21 1.79-21.21 34.22 0 34.22a19.94 19.94 0 0 0 14.14-5.83L82.46 99.9a19.94 19.94 0 0 0 5.83-14.14"/><path fill="#980200" d="M44.16 41.59c1.57.09 16.22.65 17.11 17.11.72 10-7.18 17.37-7.18 27.08 1.79 24.21 34.22 21.21 34.22 0a19.94 19.94 0 0 0-5.83-14.14L58.3 47.45a19.94 19.94 0 0 0-14.14-5.83"/><path fill="red" d="M.08 85.75c.09-1.57.65-16.22 17.11-17.11 10-.72 17.38 7.18 27.08 7.18 24.21-1.82 21.21-34.22 0-34.22a19.94 19.94 0 0 0-14.14 5.83L5.94 71.61A19.94 19.94 0 0 0 .11 85.75"/></g></svg>
\ No newline at end of file
diff --git a/docs/dns.en.md b/docs/dns.en.md
index 2f431a18..8ee0130f 100644
--- a/docs/dns.en.md
+++ b/docs/dns.en.md
@@ -125,4 +125,22 @@ Encrypted DNS proxy software provides a local proxy for the [unencrypted DNS](ba
         - [:fontawesome-brands-linux: Linux](https://github.com/DNSCrypt/dnscrypt-proxy/wiki/Installation-linux)
         - [:fontawesome-brands-github: Source](https://github.com/DNSCrypt/dnscrypt-proxy)
 
+## Self-hosted Solutions
+
+### Pi-hole
+
+!!! recommendation
+
+    ![Pi-hole logo](assets/img/dns/pi-hole.svg){ align=right }
+
+    **Pi-hole** is an open-source [DNS-sinkhole](https://wikipedia.org/wiki/DNS_sinkhole) which uses [DNS filtering](https://www.cloudflare.com/learning/access-management/what-is-dns-filtering/) to block unwanted web content, such as advertisements.
+
+    Pi-hole is designed to be hosted on a Raspberry Pi, but it is not limited to such hardware. The software features a friendly web interface to view insights and manage blocked content.
+
+    [Website](https://pi-hole.net/){ .md-button .md-button--primary } [Privacy Policy](https://pi-hole.net/privacy/){ .md-button }
+
+    ??? downloads
+
+        - [:fontawesome-brands-github: Source](https://github.com/pi-hole/pi-hole)
+
 --8<-- "includes/abbreviations.en.md"
diff --git a/docs/tools.en.md b/docs/tools.en.md
index 4c0b1e7c..1f47921f 100644
--- a/docs/tools.en.md
+++ b/docs/tools.en.md
@@ -118,10 +118,34 @@ For your convenience, everything we recommend is listed below with a link to the
 
 ### DNS
 
+**DNS Providers:**
+
 We [recommend](dns.md#recommended-providers) a number of encrypted DNS servers based on a variety of criteria, such as [Mullvad](https://mullvad.net/en/help/dns-over-https-and-dns-over-tls) and [Quad9](https://quad9.net/) amongst others. We recommend for you to read our pages on DNS before choosing a provider. In many cases, using an alternative DNS provider is not recommended.
 
 [Learn more :material-arrow-right:](dns.md)
 
+**Encrypted DNS Proxies:**
+
+<div class="grid cards" markdown>
+
+- ![RethinkDNS logo](assets/img/android/rethinkdns.svg#only-light){ .twemoji }![RethinkDNS logo](assets/img/android/rethinkdns-dark.svg#only-dark){ .twemoji } [RethinkDNS](dns.md#rethinkdns)
+- ![DNSCloak logo](assets/img/ios/dnscloak.png){ .twemoji } [DNSCloak](dns.md#dnscloak)
+- ![dnscrypt-proxy logo](assets/img/dns/dnscrypt-proxy.svg){ .twemoji } [dnscrypt-proxy](dns.md#dnscrypt-proxy)
+
+</div>
+
+[Learn more :material-arrow-right:](dns.md#encrypted-dns-proxies)
+
+**Self-hosted Solutions:**
+
+<div class="grid cards" markdown>
+
+- ![Pi-hole logo](assets/img/dns/pi-hole.svg){ .twemoji } [Pi-hole](dns.md#pi-hole)
+
+</div>
+
+[Learn more :material-arrow-right:](dns.md#self-hosted-solutions)
+
 ### Email
 
 <div class="grid cards" markdown>