Unverified Commit c05d1de4 authored by Sheogorath's avatar Sheogorath
Browse files

Add README with tutorial

parent 1e5f45d7
Running an own DNS over HTTPS (DoH) server seems to be not so common. Even when the technology gets more and more traction. Chromium/-e as well as Firefox have implemented it in their browser and run requests to major DNS providers like Google or Cloudflare.
In order to liberate and democratize the usage of DoH this container image provides the base to run a setup along with any recursive DNS server you like.
The example docker-compose runs along with [secns' unbound](https://hub.docker.com/r/secns/unbound) that provides DNSSec validation.
The project itself is based on [m13253's work](https://github.com/m13253/dns-over-https) providing a DoH-proxy in golang.
The current example requires you to have a HTTPS reverse-proxy running.
git clone https://octo.sh/container-library/dns-over-https.git
cd dns-over-https
docker-compose up -d
This will download and setup the mentioned unbound DNS server along with the proxy, which will be exposed on ``.
To test that it's working run: `curl ''`
Or `curl '' | jq` when you prefer a beautified output.
Setup a reverse proxy that takes care of HTTPS and you can [set it up on your browser](https://support.mozilla.org/en-US/kb/connection-settings-firefox) :tada:
......@@ -9,4 +9,4 @@ services:
- "8053:8053"
- ""
Supports Markdown
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment