This commit is contained in:
Mike McFetridge
2026-07-20 09:23:17 -04:00
parent c1315882da
commit 72272e4006
3179 changed files with 562960 additions and 14 deletions
+2
View File
@@ -0,0 +1,2 @@
# Technitium DNS Server credentials
DNS_SERVER_ADMIN_PASSWORD=<< dns_server_admin_password >>
+141
View File
@@ -0,0 +1,141 @@
---
services:
<< service_name >>:
image: docker.io/technitium/dns-server:15.1.0
restart: << restart_policy >>
<%- if container_name %>
container_name: << container_name >>
<%- endif %>
<%- if container_hostname %>
hostname: << container_hostname >>
<%- endif %>
environment:
- DNS_SERVER_DOMAIN=<< dns_server_domain >>
- DNS_SERVER_ADMIN_PASSWORD=${DNS_SERVER_ADMIN_PASSWORD}
- DNS_SERVER_LOG_FOLDER_PATH=/var/log/technitium/dns
- DNS_SERVER_LOG_USING_LOCAL_TIME=<< dns_server_log_using_local_time | lower >>
- DNS_SERVER_RECURSION=<< dns_server_recursion >>
<%- if dns_server_forwarders %>
- DNS_SERVER_FORWARDERS=<< dns_server_forwarders >>
- DNS_SERVER_FORWARDER_PROTOCOL=<< dns_server_forwarder_protocol >>
<%- endif %>
<%- if dns_server_enable_blocking %>
- DNS_SERVER_ENABLE_BLOCKING=true
<%- endif %>
<%- if dns_server_optional_protocol_dns_over_http %>
- DNS_SERVER_OPTIONAL_PROTOCOL_DNS_OVER_HTTP=true
<%- endif %>
<%- if network_mode == 'host' %>
network_mode: host
<%- elif network_mode == 'bridge' or network_mode == 'macvlan' or traefik_enabled %>
networks:
<%- if traefik_enabled %>
<< traefik_network >>:
<%- endif %>
<%- if network_mode == 'macvlan' %>
<< network_name >>:
ipv4_address: << network_macvlan_ipv4_address >>
<%- elif network_mode == 'bridge' %>
<< network_name >>:
<%- endif %>
<%- endif %>
<%- if not network_mode or network_mode == 'bridge' or traefik_enabled %>
ports:
<%- if not traefik_enabled %>
- "<< ports_web_http >>:5380/tcp"
- "<< ports_dns_over_https >>:443/tcp"
<%- if dns_server_optional_protocol_dns_over_http %>
- "<< ports_dns_over_http >>:80/tcp"
<%- endif %>
<%- endif %>
- "<< ports_dns >>:53/tcp"
- "<< ports_dns >>:53/udp"
<%- endif %>
volumes:
<%- if volume_mode == 'mount' %>
- << volume_mount_path >>/config:/etc/dns:rw
- << volume_mount_path >>/logs:/var/log/technitium/dns:rw
<%- else %>
- << service_name >>_config:/etc/dns
- << service_name >>_logs:/var/log/technitium/dns
<%- endif %>
<%- if network_mode != 'host' %>
sysctls:
- net.ipv4.ip_local_port_range=1024 65535
<%- endif %>
<%- if traefik_enabled %>
labels:
- traefik.enable=true
- traefik.docker.network=<< traefik_network >>
- traefik.http.services.<< service_name >>-web.loadBalancer.server.port=5380
- traefik.http.routers.<< service_name >>-http.service=<< service_name >>-web
- traefik.http.routers.<< service_name >>-http.rule=Host(`<< traefik_host >>.<< traefik_domain >>`)
- traefik.http.routers.<< service_name >>-http.entrypoints=<< traefik_entrypoint >>
<%- if traefik_tls_enabled %>
- traefik.http.routers.<< service_name >>-https.service=<< service_name >>-web
- traefik.http.routers.<< service_name >>-https.rule=Host(`<< traefik_host >>.<< traefik_domain >>`)
- traefik.http.routers.<< service_name >>-https.entrypoints=<< traefik_tls_entrypoint >>
- traefik.http.routers.<< service_name >>-https.tls=true
- traefik.http.routers.<< service_name >>-https.tls.certresolver=<< traefik_tls_certresolver >>
<%- if dns_server_optional_protocol_dns_over_http %>
- traefik.http.services.<< service_name >>-doh.loadBalancer.server.port=80
- traefik.http.routers.<< service_name >>-doh.service=<< service_name >>-doh
- traefik.http.routers.<< service_name >>-doh.rule=Host(`<< traefik_host >>.<< traefik_domain >>`) && Path(`/dns-query`)
- traefik.http.routers.<< service_name >>-doh.entrypoints=<< traefik_tls_entrypoint >>
- traefik.http.routers.<< service_name >>-doh.tls=true
- traefik.http.routers.<< service_name >>-doh.tls.certresolver=<< traefik_tls_certresolver >>
- traefik.http.routers.<< service_name >>-doh.priority=100
<%- endif %>
<%- endif %>
<%- endif %>
<%- if network_mode == 'bridge' or network_mode == 'macvlan' or traefik_enabled %>
networks:
<%- if network_mode == 'bridge' or network_mode == 'macvlan' %>
<< network_name >>:
<%- if network_external %>
external: true
<%- else %>
<%- if network_mode == 'macvlan' %>
driver: macvlan
driver_opts:
parent: << network_macvlan_parent_interface >>
ipam:
config:
- subnet: << network_macvlan_subnet >>
gateway: << network_macvlan_gateway >>
name: << network_name >>
<%- else %>
driver: bridge
<%- endif %>
<%- endif %>
<%- endif %>
<%- if traefik_enabled %>
<< traefik_network >>:
external: true
<%- endif %>
<%- endif %>
<%- if volume_mode == 'local' %>
volumes:
<< service_name >>_config:
driver: local
<< service_name >>_logs:
driver: local
<%- elif volume_mode == 'nfs' %>
volumes:
<< service_name >>_config:
driver: local
driver_opts:
type: nfs
o: addr=<< volume_nfs_server >>,nfsvers=4,<< volume_nfs_options >>
device: ":<< volume_nfs_path >>/config"
<< service_name >>_logs:
driver: local
driver_opts:
type: nfs
o: addr=<< volume_nfs_server >>,nfsvers=4,<< volume_nfs_options >>
device: ":<< volume_nfs_path >>/logs"
<%- endif %>
+469
View File
@@ -0,0 +1,469 @@
{
"slug": "technitium",
"kind": "compose",
"metadata": {
"name": "Technitium DNS Server",
"description": "Authoritative and recursive DNS server with a web console, DNS blocking, and optional forwarders for self-hosted networks.",
"tags": [
"traefik",
"network",
"volume",
"dns"
],
"icon": {
"provider": "selfhst",
"id": "technitium"
},
"draft": false,
"version": {
"name": "15.1.0",
"source_dep_name": "docker.io/technitium/dns-server",
"source_dep_version": "15.1.0"
}
},
"variables": [
{
"title": "General",
"name": "general",
"items": [
{
"name": "service_name",
"type": "str",
"title": "Service Name",
"required": false,
"default": "technitium",
"config": {
"placeholder": "technitium"
}
},
{
"name": "container_name",
"type": "str",
"title": "Container Name",
"required": false,
"default": "technitium",
"config": {
"placeholder": "technitium"
}
},
{
"name": "container_hostname",
"type": "str",
"title": "Container Hostname",
"required": false,
"default": "technitium",
"config": {
"placeholder": "technitium"
}
},
{
"name": "restart_policy",
"type": "enum",
"title": "Restart Policy",
"required": true,
"default": "unless-stopped",
"config": {
"options": [
"unless-stopped",
"always",
"on-failure",
"no"
]
}
}
]
},
{
"title": "DNS Server",
"name": "dns-server",
"items": [
{
"name": "dns_server_domain",
"type": "str",
"title": "Server Domain",
"required": true,
"default": "dns-server",
"config": {
"placeholder": "dns-server"
},
"description": "Primary domain name used by this DNS server to identify itself."
},
{
"name": "dns_server_admin_password",
"type": "secret",
"title": "Admin Password",
"required": false,
"description": "Initial admin password for the DNS web console.",
"config": {
"autogenerated": {
"length": 32
}
}
},
{
"name": "dns_server_recursion",
"type": "enum",
"title": "Recursion",
"required": true,
"default": "AllowOnlyForPrivateNetworks",
"config": {
"options": [
"Allow",
"Deny",
"AllowOnlyForPrivateNetworks",
"UseSpecifiedNetworkACL"
]
},
"description": "DNS recursion policy."
},
{
"name": "dns_server_forwarders",
"type": "str",
"title": "Forwarders",
"required": false,
"default": "1.1.1.1,9.9.9.9",
"config": {
"placeholder": "1.1.1.1,9.9.9.9"
},
"description": "Comma-separated upstream DNS forwarders. Leave empty to use recursive resolution."
},
{
"name": "dns_server_forwarder_protocol",
"type": "enum",
"title": "Forwarder Protocol",
"required": true,
"default": "Udp",
"config": {
"options": [
"Udp",
"Tcp",
"Tls",
"Https",
"HttpsJson"
]
},
"needs": [
"dns_server_forwarders"
]
},
{
"name": "dns_server_enable_blocking",
"type": "bool",
"title": "Enable Blocking",
"required": false,
"default": false
},
{
"name": "dns_server_optional_protocol_dns_over_http",
"type": "bool",
"title": "Enable DNS-over-HTTP",
"required": false,
"default": false,
"description": "Enable Technitium's DNS-over-HTTP listener on port 80. This is required when running behind a TLS-terminating reverse proxy like Traefik and you want DNS-over-HTTPS on /dns-query."
},
{
"name": "dns_server_log_using_local_time",
"type": "bool",
"title": "Use Local Time For Logs",
"required": false,
"default": true
}
]
},
{
"title": "Ports",
"name": "ports",
"items": [
{
"name": "ports_web_http",
"type": "int",
"title": "Web Console Port",
"required": false,
"default": 5380,
"config": {
"placeholder": "5380"
},
"description": "Host port exposed for the Technitium web console when Traefik is disabled."
},
{
"name": "ports_dns_over_http",
"type": "int",
"title": "DNS-over-HTTP Port",
"required": false,
"default": 80,
"config": {
"placeholder": "80"
},
"description": "Host port exposed for Technitium DNS-over-HTTP when Traefik is disabled. Behind Traefik, /dns-query is routed to container port 80 instead.",
"needs": [
"dns_server_optional_protocol_dns_over_http=true"
]
},
{
"name": "ports_dns_over_https",
"type": "int",
"title": "DNS-over-HTTPS Port",
"required": false,
"default": 443,
"config": {
"placeholder": "443"
},
"description": "Host port exposed for native Technitium DNS-over-HTTPS when Traefik is disabled."
},
{
"name": "ports_dns",
"type": "int",
"title": "DNS Port",
"required": true,
"default": 53,
"config": {
"placeholder": "53"
}
}
]
},
{
"title": "Traefik",
"name": "traefik",
"toggle": "traefik_enabled",
"items": [
{
"name": "traefik_enabled",
"type": "bool",
"title": "Traefik",
"required": false,
"default": false
},
{
"name": "traefik_host",
"type": "str",
"title": "Host",
"required": true,
"config": {
"placeholder": "technitium"
}
},
{
"name": "traefik_domain",
"type": "str",
"title": "Domain",
"required": true,
"config": {
"placeholder": "home.arpa"
}
},
{
"name": "traefik_entrypoint",
"type": "str",
"title": "Entrypoint",
"required": true,
"default": "web",
"config": {
"placeholder": "web"
}
},
{
"name": "traefik_network",
"type": "str",
"title": "Network",
"required": true,
"default": "traefik",
"config": {
"placeholder": "traefik"
}
},
{
"name": "traefik_tls_enabled",
"type": "bool",
"title": "TLS",
"required": false,
"default": false
},
{
"name": "traefik_tls_entrypoint",
"type": "str",
"title": "TLS Entrypoint",
"required": true,
"default": "websecure",
"config": {
"placeholder": "websecure"
},
"needs": [
"traefik_tls_enabled=true"
]
},
{
"name": "traefik_tls_certresolver",
"type": "str",
"title": "Cert Resolver",
"required": true,
"default": "cloudflare",
"config": {
"placeholder": "cloudflare"
},
"needs": [
"traefik_tls_enabled=true"
]
}
]
},
{
"title": "Network",
"name": "network",
"items": [
{
"name": "network_mode",
"type": "str",
"title": "Network Mode",
"required": false,
"description": "Network mode. Use bridge for normal Docker networking, macvlan for a dedicated LAN IP, or host for DHCP-style deployments."
},
{
"name": "network_name",
"type": "str",
"title": "Network Name",
"required": false,
"default": "technitium_network",
"config": {
"placeholder": "technitium_network"
}
},
{
"name": "network_macvlan_ipv4_address",
"type": "str",
"title": "IPv4 Address",
"required": true,
"default": "IP_ADDRESS",
"needs": [
"network_mode=macvlan"
],
"config": {
"placeholder": "IP_ADDRESS"
},
"description": "Static IPv4 address for the macvlan network."
},
{
"name": "network_macvlan_parent_interface",
"type": "str",
"title": "Parent Interface",
"required": true,
"default": "eth0",
"needs": [
"network_mode=macvlan"
],
"config": {
"placeholder": "eth0"
},
"description": "Parent interface for the macvlan network."
},
{
"name": "network_macvlan_subnet",
"type": "str",
"title": "Subnet",
"required": true,
"default": "IP_RANGE",
"needs": [
"network_mode=macvlan"
],
"config": {
"placeholder": "IP_RANGE"
},
"description": "Subnet for the macvlan network."
},
{
"name": "network_macvlan_gateway",
"type": "str",
"title": "Gateway",
"required": true,
"default": "GATEWAY",
"needs": [
"network_mode=macvlan"
],
"config": {
"placeholder": "GATEWAY"
},
"description": "Gateway for the macvlan network."
},
{
"name": "network_external",
"type": "bool",
"title": "External Network",
"required": false,
"default": false
}
]
},
{
"title": "Volume",
"name": "volume",
"items": [
{
"name": "volume_mode",
"type": "enum",
"title": "Volume Mode",
"required": true,
"default": "local",
"config": {
"options": [
"local",
"mount",
"nfs"
]
}
},
{
"name": "volume_mount_path",
"type": "str",
"title": "Volume Mount Path",
"required": true,
"default": "/data",
"needs": [
"volume_mode=mount"
],
"config": {
"placeholder": "/data"
}
},
{
"name": "volume_nfs_server",
"type": "str",
"title": "Volume Nfs Server",
"required": true,
"default": "NFS_SERVER",
"needs": [
"volume_mode=nfs"
],
"config": {
"placeholder": "NFS_SERVER"
}
},
{
"name": "volume_nfs_path",
"type": "str",
"title": "Volume Nfs Path",
"required": true,
"default": "/export",
"needs": [
"volume_mode=nfs"
],
"config": {
"placeholder": "/export"
}
},
{
"name": "volume_nfs_options",
"type": "str",
"title": "Volume Nfs Options",
"required": true,
"default": "rw,nolock,soft",
"needs": [
"volume_mode=nfs"
],
"config": {
"placeholder": "rw,nolock,soft"
}
}
]
}
]
}