README.md

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 requirements:

• docker
• docker-compose

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
   

Basic updns building blocks

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

---

Nysos Tech e.U., Markus Donko-Huber 2024