Skip to content


Repository files navigation

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 repo 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

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