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 the UDP protocol. In this step by step guide I will show you how to install Technitium on your UGREEN NAS using Docker & Portainer.
STEP 1
Please Support My work by Making a Donation.
STEP 2
InstallĀ Portainer using my step by step guide. If you already have Portainer installed on your UGREEN NAS, skip this STEP. Attention: Make sure you have installed the latest Portainer version.
STEP 3
ā ļøMandatory STEP: If you have already installed the PiHole or Adguard container, remember to disable or simply stop them to be able to use Technitium since Technitium uses the same default port 53 as PiHole and Adguard.
STEP 4
Go toĀ Files and open the docker folder. Inside the docker folder, create one new folder and name it technitium. Follow the instructions in the image below.
Note: Be careful to enter only lowercase, not uppercase letters.
STEP 5
Log into Portainer using your username and password. On the left sidebar in Portainer, click onĀ HomeĀ thenĀ Live connect. Follow the instructions in the image below.
On the left sidebar in Portainer, click on StacksĀ thenĀ + Add stack. Follow the instructions in the image below.
STEP 6
In the Name field type in technitium. Follow the instructions in the image below.
########################### NETWORKS
networks:
macvlan_net:
driver: macvlan
driver_opts:
parent: eth0 # In my case is eth0 check your own parent using ifconfig.
ipam:
config:
- subnet: 192.168.0.0/24 #Replace with your desired subnet.
gateway: 192.168.0.1 #On your UGREEN NAS, go to Control Panel / Network / General Tab / Check your Default Gateway.
########################### SERVICES
services:
technitium:
image: technitium/dns-server:latest
container_name: Technitium
healthcheck:
test: timeout 10s bash -c ':> /dev/tcp/127.0.0.1/5380' || exit 1
interval: 10s
timeout: 5s
retries: 3
start_period: 90s
hostname: dns-server
networks:
macvlan_net:
ipv4_address: 192.168.0.105 #Assign a static IP within subnet to avoid conflicts.
security_opt:
- no-new-privileges:false
volumes:
- /volume1/docker/technitium:/etc/dns:rw
environment:
DNS_SERVER_DOMAIN: home.lan
DNS_SERVER_LOG_USING_LOCAL_TIME: true
TZ: Europe/Bucharest
restart: unless-stopped
Note: Before you paste the code above in the Web editor area below, change the value for subnet. Replace with your desired subnet.
Note: Before you paste the code above in the Web editor area below, change the value for gateway. On your UGREEN NAS, go to Control Panel / Network / General Tab / Check your Default Gateway.
Note: Before you paste the code above in the Web editor area below, change the value for ipv4_address. Assign a static IP within subnet to avoid conflicts. You will need this IP later at STEP 10.
Note: Before you paste the code above in the Web editor area below, change the value for TZ.Ā (Select your current Time Zone from this list.)
STEP 7
Scroll down on the page until you see a button namedĀ Deploy the stack. Click on it. Follow the instructions in the image below. The installation process can take up to a few minutes. It will depend on your Internet speed connection.
STEP 8
If everything goes right, you will see the following message at the top right of your screen: āSuccess Stack successfully deployedā.
STEP 9
š¢Please Support My work by Making a Donation. Almost 99,9% of the people that install something using my guidesĀ forget to support my work, or justĀ ignoreĀ STEP 1. Iāve been very honest about this aspect of my work since the beginning: I donāt run any ADS, I donāt require subscriptions, paid or otherwise, I donāt collect IPs, emails, and I donāt have any referral links from Amazon or other merchants. I also donāt have any POP-UPs or COOKIES. I have repeatedly been told over the years how much I have contributed to the community. Itās something I love doing and have been honest about my passion since the beginning. But I also Need The Community to Support me Back to be able to continue doing this work.
STEP 10
The installation process can take up to a few seconds/minutes. It will depend on your Internet speed connection. Now open your browser and type in your own ipv4_address that you have previously added at STEP 6, followed by :5380 In my case it’s http://192.168.0.105:5380 You will be prompted to change the default password with your own new password. Type in your New Password.Ā Click Change. Follow the instructions in the image below.
STEP 11
Your Technitium dashboard at a glance!
STEP 12
On your Windows 11 Desktop PC search for Settings. Once you find it, click Open. Follow the instructions in the image below.
STEP 13
On the left sidebar click Network & Internet. Select your Ethernet connection, then click the little arrow. Follow the instructions in the image below.
STEP 14
Scroll down until you find the option “DNS server assignment“. Click Edit. Follow the instructions in the image below.
STEP 15
Edit DNS settings. Instead of Automatic DHCP, choose Manual. Turn ON IPv4. Add your own ipv4_address that you have previously added at STEP 6,Ā then click Save. Follow the instructions in the image below.
Note: If you want to run the Technitium container over HTTPS, check out How to Run Docker Containers Over HTTPS on Your UGREEN NAS.
ā ļøMandatory Add Read & Write Permissions to the Docker Folder. If you have already added the Read and Write Permissions to the Docker Folder, skip this STEP.
šNote/Update/Container: How to Update Your Docker Containers on UGREEN NAS Using Portainer.
š³Note: How to Create Docker Shortcuts on Desktop.
šNote: How to Update Portainer to the latest version.
šNote: How to Clean Docker.
This post was updated on Monday / December 15th, 2025 at 7:48 PM