Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.

Usable Privacy DNS (updns)

GitHub release (latest by date) GitHub Workflow Status GitHub

updns is a privacy-protecting DNS resolver with advertising and tracker blocking. This code powers 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:


  1. Fetch the latest updns source code from Github
    git clone
  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 spawns ad-blocking DoH + DoT servers.
    • The Docker compose setup is ready for deployment with traefik2 (edge routing + TLS)
  • Basic updns Services

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