DNS Server
DNS Server
| Installed Apps | ||
|---|---|---|
| Total Apps: 0 | ||
| Scope | MAC Address | IP Address | Host Name | Lease Obtained | Lease Expires | ||
|---|---|---|---|---|---|---|---|
| Total Leases: 0 |
| Name | Scope Range/Subnet Mask | Network/Broadcast | Interface | |
|---|---|---|---|---|
| Total Leases: 0 |
| Section | User Permissions | Group Permissions | |
|---|---|---|---|
| Scope Name |
|---|
openid and profile are mandatory and will be automatically added if missing. Add the scope email if you want to use email address as the username for all SSO users that sign up for an account.| Remote Group | Local Group |
|---|
group or roles scope in the Scopes option above as required by the SSO provider.Note! The Single Sign-On (SSO) uses /sso/callback as the callback path. Thus, your SSO Redirect URI for this DNS Server should be http://localhost:5380/sso/callback which needs to be configure with the SSO provider.
Note! Single Sign-On (SSO) will be enabled only when all of the required parameters are configured correctly. If SSO does not work for any reason, check the Logs section on the panel and search for related error logs.
Note! When a Single Sign-On (SSO) user signs up with the DNS Server, an account for the user is created which uses the email address as the username. If email address is not available, the preferred username is used instead. If you do not wish to use email address as the username, you can remove the email scope from the Scopes option above.
Note! The Single Sign-On (SSO) user's Display Name and Username are managed via the SSO provider and they are automatically synced each time a user logs in.
Note! When Group Map is configured, the Single Sign-On (SSO) user's group membership cannot be managed locally and any group membership changes must be configured at the SSO provider itself. SSO users need to relogin so that any group membership changes made at SSO provider are applied to their user accounts. The Group Map thus allows managing user access centrally via the SSO provider. Keep the Group Map empty if group membership management for SSO users is required to be managed via the DNS Server itself.
Note! The Web Service will be automatically restarted to apply these changes thus there is no need to restart the DNS Server manually.
Note! When using a reverse proxy with the Web Service, you need to add X-Forwarded-Proto and X-Forwarded-Host headers to proxy request to allow the Web Service to correctly form the SSO Redirect URI. If the reverse proxy is setup to use a path prefix then make sure to add the X-Forwarded-Prefix header to proxy request too. These headers will be read only if the reverse proxy IP address is configured to be allowed in the Reverse Proxy Addresses option in Settings > Web Service section. For example, if you are using nginx as the reverse proxy with a path prefix of /dns, then you should add the following headers: proxy_set_header X-Forwarded-Proto $scheme;, proxy_set_header X-Forwarded-Host $host;, proxy_set_header X-Forwarded-Prefix /dns;, and proxy_redirect / /dns/;
Warning! All URLs configured above must use https URL scheme for production environments. Using http URL scheme is not secure and should be used only for testing purposes.
Warning! Any DNS related failure may cause Single Sign-On (SSO) to fail to work making it impossible for SSO users to log in to fix the DNS issue due to circular dependency. Thus, it is recommended to maintain a local administrator user account for such scenarios.
Technitium DNS Server
Version
Server up since
Copyright (C) 2026 Shreyas Zare (shreyas@technitium.com)
This program comes with ABSOLUTELY NO WARRANTY. This is free software, and you are welcome to redistribute it under certain conditions.
Source code available under GNU General Public License v3.0 on GitHub
What's New?
Read the change log to know what's new in this release.
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 this web console and thus all the actions that this 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 support@technitium.com.
Follow @technitium@mastodon.social on Mastodon.
Checkout Technitium Blog.
Join /r/technitium on Reddit.
Donate
Make a contribution to Technitium and help making new software, updates, and features possible.