# 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 to an encrypted remote resolver. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/1656/doh-client

## Description

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.

## Health score

37/100 (Low), based on 4 of 5 factors.
- Maintained: 28 (last commit 447 days ago)
- Popular: 41 (105 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Security check: 54 (no serious findings, 5 minor, CI, tests, OpenSSF Scorecard 3.1/10)

## Links

- Docker Hub: https://hub.docker.com/r/ich777/doh-client
- GitHub: https://github.com/LinkTed/doh-client
- Unraid: https://ca.unraid.net/apps/doh-client-0uvvhis1rcltu0?q=DoH-Client

## 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.

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