DoH-Client

DoH-Client is a Docker container that runs a DNS over HTTPS (DoH) client: it exposes a local UDP DNS port and forwards every DNS query from your internal…

  • Network Services
  • Tools & Utilities
DoH-Client is a Docker container that runs a DNS over HTTPS (DoH) client: it exposes a local UDP DNS port and forwards every DNS query from your internal network to an encrypted remote resolver. By default it connects to Google's and DNS.SB's DoH resolvers with Encrypted Client Extensions (ECS) disabled, and you can change the resolver or re-enable ECS by editing the doh-client.conf file in the container. This keeps your DNS lookups hidden from your ISP, can run in front of Pi-hole for ad blocking, and works alongside a DoH server to encrypt queries from mobile devices as well.

Platform availability

Available on 1 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

37/100 Low

Maintained
28last commit 447 days ago
Popular
41105 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
No data
Security check
54no serious findings, 5 minor, CI, tests, OpenSSF Scorecard 3.1/10

Based on 4 of 5 factors.

Availability: platform listings confirmed today, links checked 39 days ago

GitHub stars
105
Open issues
8
Last commit
2025-08-31
License
BSD-3-Clause
Activity
stale

Checked 20 days ago - source: GitHub (LinkTed/doh-client)

Resources & Compatibility

ARM (e.g. Raspberry Pi) is supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Check the telemetry privacy note Before first use, review the privacy note: DoH-Client may send resolver-study telemetry with DNS (name-to-IP lookup) test results for doh.test, whoartthou, and a UUID-based test domain, plus a client UUID (a random ID the app creates). Without checking, you may not realize those test answers and ID leave your device. source
  • Static IP and custom mode Run the container in custom mode with a static IP address and expose all its ports; the author recommends this to avoid the network problems that can occur with the default setup. source

Fetched 45 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

Does DoH-Client expose a local DNS port for my internal network?

Yes, it opens a local UDP DNS port and forwards all DNS queries to a remote HTTP/2.0 server.

Which DNS over HTTPS protocols are supported?

It can query DNS over HTTPS using Google's DNS-over-HTTPS protocol and the IETF RFC 8484 standard.

Where do DoH-Client logs appear?

Log lines from doh-client and doh-server are written to stderr, so you can view them with your OS logging tool, such as journalctl under systemd.

Can Android devices use a custom DoH endpoint for all system DNS?

Android only supports DoH for Google and Cloudflare, so a custom DoH path works in browsers but not as a system-wide DNS setting.

Can local devices keep using normal DNS while outgoing queries are encrypted?

A router or bridge can accept traditional DNS from local devices and send outgoing queries over DoH.

Answers sourced from github.com, github.com, www.reddit.com, www.redditmedia.com

Community

Collected 31 days ago - public community threads