updns

KO | EN

gitlite — search

#python #llm #golang #machine-learning #deep-learning #macos #java #cli #kubernetes #vue #pytorch #ios #mcp #openai

(★ 46)

Public Adfree DNS over HTTPS Server

updns Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# [Usable Privacy DNS (updns)](https://docs.usableprivacy.com/dns)

![GitHub release (latest by date)](https://img.shields.io/github/v/release/usableprivacy/updns)
![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/usableprivacy/updns/main.yml?branch=master)
![GitHub](https://img.shields.io/github/license/usableprivacy/updns)

**updns** is a privacy-protecting DNS resolver with advertising and tracker blocking.
This repo powers **[adfree.usableprivacy.net](https://docs.usableprivacy.com/dns)** 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](docker-compose.yml) deploys ad-blocking DoH + DoT servers.
* Basic **updns** Services
  * [cryptodns](cryptodns) deploys `dnsdist` for DoH and DoT endpoints.
  * [letsencrypt](letsencrypt) deploys `certbot` to get valid TLS certificates.
  * [recursor](recursor) deploys `pdns-recursor` for filtering, see [filterlist.lua](recursor/conf/filterlist.lua)

### Setup

1) Fetch the latest **updns** source code from GitHub

```bash
    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

```bash
   docker compose up
   ```

updns

updns Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

updns

updns Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README