From 97a407b3bf07d30515a5f31a285e4419772b0240 Mon Sep 17 00:00:00 2001
From: Crimekillz <crimekillz@161.sh>
Date: Wed, 17 Apr 2024 21:09:57 +0200
Subject: [PATCH] Add info on how to use a custom resolver

---
 docs/custom-dns.md               | 34 ++++++++++++++++++++++++++++++++
 docs/examples/docker-compose.yml |  4 ++++
 2 files changed, 38 insertions(+)
 create mode 100644 docs/custom-dns.md

diff --git a/docs/custom-dns.md b/docs/custom-dns.md
new file mode 100644
index 000000000..c5809f193
--- /dev/null
+++ b/docs/custom-dns.md
@@ -0,0 +1,34 @@
+# How to resolve Domains to custom IPs by using dnsmasq on the host
+
+First edit /etc/hosts and add your overrides.
+
+Then run the following commands (Arch Linux) to install, enable and start dnsmasq
+
+```
+# pacman -S dnsmasq
+# systemctl enable dnsmasq
+# systemctl start dnsmasq
+```
+
+Uncomment or add the following config to your docker-compose.yml web service section (172.17.0.1 is the docker default network IP):
+
+```
+    dns:
+	  - 172.17.0.1
+```
+
+After changing /etc/hosts you can do
+
+```
+# systemctl restart dnsmasq
+```
+
+# How to use a different resolver
+
+Uncomment or add the following config to your docker-compose.yml web service section (172.17.0.1 is the docker default network IP):
+
+```
+    dns:
+	  - 1.1.1.1
+	  - 1.0.0.1
+```
diff --git a/docs/examples/docker-compose.yml b/docs/examples/docker-compose.yml
index e90778dd0..643680055 100644
--- a/docs/examples/docker-compose.yml
+++ b/docs/examples/docker-compose.yml
@@ -25,6 +25,10 @@ services:
     volumes:
       - ./files:/trashposs/files
       - ./.config:/trashposs/.config:ro
+# Uncomment this to use a DNS server on the host machine or specify a custom one
+# (172.17.0.1 is the IP of the default network bridge)
+#   dns:
+#     - 172.17.0.1
 
   redis:
     restart: unless-stopped