https://github.com/staerk-ha-addons/addon-technitium-dns
🏠 Modern DNS server add-on for Home Assistant with DoH, DoT, and DoQ support. Features automatic configuration, secure forwarding, local zones, and seamless integration.
https://github.com/staerk-ha-addons/addon-technitium-dns
dns-over-https dns-over-quic dns-over-tls dns-resolver dns-server home-assistant home-assistant-addons homeassistant homeassistant-addons
Last synced: 6 months ago
JSON representation
🏠 Modern DNS server add-on for Home Assistant with DoH, DoT, and DoQ support. Features automatic configuration, secure forwarding, local zones, and seamless integration.
- Host: GitHub
- URL: https://github.com/staerk-ha-addons/addon-technitium-dns
- Owner: staerk-ha-addons
- License: mit
- Created: 2025-04-12T11:59:31.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-04-19T17:44:57.000Z (7 months ago)
- Last Synced: 2025-04-27T00:58:30.798Z (6 months ago)
- Topics: dns-over-https, dns-over-quic, dns-over-tls, dns-resolver, dns-server, home-assistant, home-assistant-addons, homeassistant, homeassistant-addons
- Language: Shell
- Homepage: https://github.com/staerk-ha-addons/repository
- Size: 565 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# 🏠 Home Assistant Add-on: Technitium DNS Server
[![GitHub Release][releases-shield]][releases]
![Project Stage][project-stage-shield]
[![License][license-shield]](LICENSE.md)
> [!TIP]
> ⭐ Love this add-on? Show your support by giving a [star on GitHub!][repository] Every star helps make this project more visible and encourages continued development.
## 🌐 Modern DNS Solution for Home Assistant
A fully featured DNS server for Home Assistant that acts as a secure forwarding DNS server, querying external providers using modern encrypted protocols. Perfect for improving your home network's privacy and security.
## ✨ Features
A fully featured DNS server for Home Assistant that:
- 🔒 Securely forwards DNS queries using DoH/DoT/DoQ
- 🌐 Supports local DNS zones and custom domains
- 🔄 Auto-configures with Home Assistant
- 📋 Manages SSL certificates automatically
- 🚀 Uses Cloudflare DNS with modern protocols
- ⚡ Provides fast DNS caching
- 🛡️ Includes DNS filtering and blocking
## 🏃 Quick Start
1. Click the Home Assistant My button below to add the repository to your Home Assistant instance.
[](https://my.home-assistant.io/redirect/supervisor_add_addon_repository/?repository_url=https%3A%2F%2Fgithub.com%2Fstaerk-ha-addons%2Frepository)
2. Find the "Technitium DNS Server" add-on in the add-on store.
3. Click "Install" to download the add-on.
4. Click "Start" to start the add-on.
5. Check the logs of the add-on to see if everything went well.
6. Click "Open Web Ui" and login.
> [!NOTE]
> When accessing the web interface for the first time:
>
> - **Username:** `admin`
> - **Password:** `admin`
>
> You will be required to change the password on your first login for security purposes.
## 📖 Documentation
Want to get the most out of this add-on? Our comprehensive documentation covers:
- Detailed setup guides
- Configuration options
- Best practices
- Local DNS hosting
- Troubleshooting
- Client setup examples
Check the [:books: DOCS.md][docs] for full details.
## DNS Flow and Protocol Options
> This diagram illustrates how DNS queries flow through your network, showing both unencrypted (🔓) and encrypted (🔐) paths. Local devices can use either standard DNS or secure protocols (DoH/DoT/DoQ) to query the Technitium DNS Server, which then forwards requests to Cloudflare using selected forwarders.
![DNS flow diagram][dns-diagram]
### Key Points
- 🏡 **Local Network**: Devices and router can use any supported protocol
- 🔒 **Security Options**: Choose between standard DNS or encrypted protocols
- 🌐 **Flexible Forwarding**: All protocols supported for external queries
- ⚡ **Modern Standards**: Full support for DoH, DoT, and DoQ
- 🛡️ **End-to-End**: Possible to encrypt entire DNS path
## 💡 Support
Got questions?
- Create an [issue on GitHub][issue] for bug reports, feature requests, or questions
- Add a ⭐️ [star on GitHub][repository] to support the project
## 🤝 Contributing
This is an active open-source project. We welcome contributions from anyone interested in using or improving the code:
- Fork the repository
- Make your changes
- Submit a pull request
- Follow the coding standards
## 👥 Authors & Contributors
The original setup of this repository is by [Jeppe Stærk][staerk].
## 🙏 Acknowledgments
Special thanks to [Franck Nijhof][frenck] and the [Home Assistant Community Add-ons][ha-addons] project for their invaluable work. This add-on heavily relies on their foundation:
- Base container images
- CI, workflows and best practices
- Readme and docs templates
Their open-source contributions make add-ons like this possible.
## ⚠️ Disclaimer
This is a third-party add-on for Home Assistant and not an official add-on. It is provided as-is, without warranty of any kind. While care has been taken in its development, use it at your own risk. Always ensure you have proper backups before making changes to your Home Assistant DNS settings. This add-on is not affiliated with Technitium Software.
## 📄 License
MIT License - Copyright (c) 2025 Jeppe Stærk
[dns-diagram]: https://raw.githubusercontent.com/staerk-ha-addons/addon-technitium-dns/refs/heads/main/images/flowchart-dns.svg
[docs]: https://github.com/staerk-ha-addons/addon-technitium-dns/blob/main/technitium-dns/DOCS.md
[frenck]: https://github.com/frenck
[issue]: https://github.com/staerk-ha-addons/addon-technitium-dns/issues
[releases-shield]: https://img.shields.io/github/release/staerk-ha-addons/addon-technitium-dns.svg
[releases]: https://github.com/staerk-ha-addons/addon-technitium-dns/releases
[repository]: https://github.com/staerk-ha-addons/repository
[staerk]: https://github.com/jepestaerk
[project-stage-shield]: https://img.shields.io/badge/project%20stage-experimental-yellow.svg
[license-shield]: https://img.shields.io/github/license/staerk-ha-addons/addon-technitium-dns.svg
[ha-addons]: https://addons.community/