# DNS-DoH-companion

DNS-DoH-companion is a self-hosted network services app. A lightweight DNS server that forwards your network's DNS queries over DNS-over-HTTPS (DoH) to a provider of your choice. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/1889/dns-doh-companion

## Description

A lightweight DNS server that forwards your network's DNS queries over DNS-over-HTTPS (DoH) to a provider of your choice. It provides encrypted lookups without the added features of a full DNS sinkhole such as Pi-hole, giving you privacy without the extra complexity. It suits home and small networks, and is useful for routing DNS through a virtual private network (VPN) container when you want encrypted lookups alongside your VPN traffic.

## Platform availability

Available on 2 of 10 platforms: Unraid, Windows.

## Desktop and other devices

Windows.

## Health score

83/100 (Excellent), based on 4 of 5 factors.
- Maintained: 100 (last commit 29 days ago)
- Popular: 83 (13,797 GitHub stars)
- Easy to install: 45 (2 install platforms, install notes, Docker image)
- Security check: 85 (no serious findings, CI, tests, OpenSSF Scorecard 6.3/10)

## Links

- Docker Hub: https://hub.docker.com/r/testdasi/simple-dns-doh/
- Official website: https://dnscrypt.info
- desktop: https://github.com/DNSCrypt/dnscrypt-proxy/releases/latest
- GitHub: https://github.com/DNSCrypt/dnscrypt-proxy
- Unraid: https://ca.unraid.net/apps/dns-doh-companion-1bc428s1kliz34?q=DNS-DoH-companion

## Common questions

### Should I check for a local port 53 conflict before running the DNS service?

Yes, make sure nothing else is running on localhost:53, because port 53 is the standard DNS port.

### What happens if my upstream DoH provider is blocked?

A self-hosted DoH server still needs a way to communicate with an upstream DNS server, so resolution can fail if both regular UDP DNS and DoH are blocked.

### How can I verify DNS-DoH-companion is resolving correctly after setup?

Ping a name that should resolve. If you get replies, DNS is working; otherwise the resolver, record, or network path is misconfigured.

### What redundancy should I consider if I self-host DNS for the whole network?

Use at least two instances on different subnets or IP ranges, and ideally host them in separate cloud providers to reduce risk.

## Alternatives

- Amazon Web Services: A pay-as-you-go cloud computing platform with services in networking, compute, storage, and IoT, accessible via global server farms.
- Anubis: Anubis is a lightweight, self-hosted web firewall that weighs each incoming connection with a proof-of-work challenge before it reaches you…
- BunkerWeb: BunkerWeb is a self-hosted, open-source web application firewall and NGINX-based web server that protects services with secure-by-default s…
- Cisco Umbrella: Cisco Umbrella (formerly OpenDNS) provides the first line of defense against threats on the internet wherever users go.
- Corvus: Self-hosted reverse proxy and web application firewall with a web console; it provides domain forwarding, free SSL, live traffic monitoring…
- CrowdSec: CrowdSec is a free, open-source IDS/IPS and WAF that detects malicious behavior by analyzing server logs and HTTP requests, then blocks off…
- DNS4EU
- DeCDN Node: deCDN Node is the daemon that runs a deCDN cache node — bond funds, serve cached content, and get paid per megabyte — deployed on Kubernete…
- DigitalOcean: Cloud computing platform with Droplets for virtual servers, managed Kubernetes, spaces for storage, and managed databases aiming at develop…
- Duck DNS: Free dynamic DNS hosted on Amazon VPC.
- Haproxy: HAProxy is a TCP proxy and a HTTP reverse proxy.

---
Source: Our Local Host (https://ourlocalhost.com/app/1889/dns-doh-companion), the self-hosted and open-source app directory.
