Usable Privacy DNS (updns)

updns is a privacy-protecting DNS resolver with advertising and tracker blocking. This repo powers adfree.usableprivacy.net a public, adblocking and non-logging DoH/DoT service.

Deploy a custom updns setup

This repository provides the source code to our public filtering encrypted DNS setup.

Basic updns building blocks

• docker-compose.yml deploys ad-blocking DoH + DoT servers.
• Basic updns Services
  • cryptodns deploys dnsdist for DoH and DoT endpoints.
  • letsencrypt deploys certbot to get valid TLS certificates.
  • recursor deploys pdns-recursor for filtering, see filterlist.lua

Setup

1. Fetch the latest updns source code from GitHub

   git clone https://github.com/usableprivacy/updns.git

2. Copy .env_example to .env and adapt it for your needs:

   • LETSENCRYPT_* environment variables for certbot
   • FQDN domain to use for your DoH / DoT server

3. Create a .ini file with our DNS API credentials for certbot

4. Deploy updns services

   docker compose up

---

© Nysos Tech e.U., 2026