DnsServer README

The project's README from github.com/TechnitiumSoftware/DnsServer. As one markdown file: README.md.

Technitium DNS Server
Technitium DNS Server


Self host a DNS server for privacy & security
Block ads & malware at DNS level for your entire network!

Technitium DNS Server

Technitium DNS Server is an open source authoritative as well as recursive DNS server that can be used for self hosting a DNS server for privacy & security. It works out-of-the-box with no or minimal configuration and provides a user friendly web console accessible using any modern web browser.

Nobody really bothers about domain name resolution since it works automatically behind the scenes and is complex to understand. Most computer software use the operating system's DNS resolver that usually query the configured ISP's DNS server using UDP protocol. This way works well for most people but, your ISP can see and control what website you can visit even when the website employ HTTPS security. Not only that, some ISPs can redirect, block or inject content into websites you visit even when you use a different DNS provider like Google DNS or Cloudflare DNS. Having Technitium DNS Server configured to use DNS-over-TLS, DNS-over-HTTPS, or DNS-over-QUIC forwarders, these privacy & security issues can be mitigated very effectively.

Be it a home network or an organization's network, having a locally running DNS server gives you more insights into your network and helps to understand it better using the DNS logs and stats. It improves overall performance since most queries are served from the DNS cache making web sites load faster by not having to wait for frequent DNS resolutions. It also gives you an additional control over your network allowing you to block domain names network wide and also allows you to route your DNS traffic securely using encrypted DNS protocols.

Sponsored By

Technology Investors and Integrators | WavSpeed Inc | Texas

Features

Supported RFCs

Read the complete list of RFCs supported by the DNS Server.

Installation

Archive

You can download binaries for the previous releases of the DNS Server from the archive.

Build Instructions

You can build the DNS Server from source and install it manually by following the Build Instructions.

Docker Environment Variables

Technitium DNS Server supports environment variables to allow initializing the config when the DNS Server starts for the first time. Read the environment variable documentation for complete details.

API Documentation

The DNS Server HTTP API allows any 3rd party app or script to configure the DNS Server. The HTTP API is used by the web console and thus all the actions that the web console does can be performed via the API. Read the HTTP API documentation for complete details.

Help Topics

Read the latest online help topics which contains the DNS Server user manual and covers frequently asked questions.

Support

For support, send an email to [email protected]. For any issues, feedback, or feature request, create an issue on GitHub.

Join /r/technitium on Reddit.

Donate

Make contribution to Technitium and help making new software, updates, and features possible.

Donate Now!

Blog Posts

DnsServer (TechnitiumSoftware/DnsServer)

Searching Database…

10.1K ·GitHub
What is this?Technitium DNS Server is an open source, self-hosted DNS server that works as both an authoritative server and a recursive resolver. Its headline use is blocking ads and malware at the DNS level for an entire home or organization network, with configuration done in a web console.
Is this something I install on every device, or run once for my whole network?You run it once on a machine serving your network — it works on Windows, Linux, macOS and Raspberry Pi, and a Docker image is also available — then point your devices' DNS at it. Everything is managed from a browser-based admin console.
How do I get it running?Windows gets a setup installer, Linux and Raspberry Pi use an install script from the linked blog post, Docker users pull the official image from Docker Hub, and a portable build runs anywhere. It installs in about a minute and works out-of-the-box with zero configuration.
Do I need .NET installed first?Only for the portable cross-platform build, which runs on any platform that has .NET 10 installed. The Windows installer, the Linux install script and the Docker image are the routes without that requirement.
Will my ISP still see and control which sites I visit?Not if you forward queries over encrypted DNS: the server can use DNS-over-TLS, DNS-over-HTTPS or DNS-over-QUIC forwarders to public resolvers like Cloudflare, Google, Quad9 or AdGuard, and can even route DNS over Tor through a SOCKS5 proxy.
Will running my own DNS server slow my browsing down?The README claims the opposite: most repeat queries are answered from the DNS cache, so sites load faster. Caching includes Serve Stale, Prefetch and a persistent cache saved to disk across restarts, and it load-tested at more than 100,000 requests/second on an Intel i7-8700 over Gigabit Ethernet.
Can it block ads for devices that can't install ad blockers, like a TV?Yes — blocking happens at the DNS level, so every device using the server is covered. You add one or more block list URLs, the Advanced Blocking DNS App adds REGEX-based lists with different rules per client IP or subnet, and CNAME cloaking catches domains hiding behind blocked ones.
Can I host my own domain names on it?Yes, it doubles as an authoritative nameserver: primary, secondary, stub and conditional forwarder zones, wildcard subdomains, DNSSEC signing with RSA, ECDSA and EdDSA, dynamic DNS updates, and zone transfers over TCP, TLS or QUIC. You can disable individual zones and records for testing.
What else is built in besides DNS resolution?A built-in DHCP server that works across multiple networks, clustering to manage several DNS server instances from one admin console, multi-user role based access with TOTP two-factor auth plus SSO via OpenID Connect or LDAP, and pluggable DNS Apps for split horizon, geolocation answers, DNS64 and more.
Size
8.5 MB
Stars
10.1K
Age
8y
Commits · 90 Days