🏠 Home Assistant Add-on: Technitium DNS Server

Tip

⭐ Love this add-on? Show your support by giving a star on GitHub! 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
• ⚡ Provides fast DNS caching
• 🛡️ Includes DNS filtering and blocking

Important

This add-on uses host networking mode to properly function as a DNS server. This means it binds directly to the host's network interfaces rather than using Docker's network isolation. Port 53 (DNS) must be available on your host system.

🏃 Quick Start

1. Click the Home Assistant My button below to add the repository to your Home Assistant instance.

   

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

Check the 📚 DOCS.md 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 dns_forwarders.

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

💡 Support

Got questions?

• Create an issue on GitHub for bug reports, feature requests, or questions
• Add a ⭐️ star on GitHub 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, I have simply moved the version to V15.2 Phil Bath

🙏 Acknowledgments

Special thanks to Franck Nijhof and the Home Assistant Community Add-ons 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