JustDNS

JustDNS

Docker app from JustDNS

JustDNS is a self-hosted filtering DNS resolver for your whole network.

Overview

JustDNS is a self-hosted filtering DNS resolver for your whole network. It blocks ads, trackers and malware, and its privacy dashboard shows which companies your devices contact, with a per-device breakdown and a world map of where answers resolve. It ships encrypted upstreams (DNS-over-TLS) by default, per-device and per-group policies, DNSSEC validation, user accounts with roles and TOTP, and optional multi-node high availability.

Point your router's or devices' DNS at this server's IP, then open the dashboard on port 8080 and finish setup in the first-run wizard.

Notes for Unraid:

  • The /keys volume holds the at-rest encryption key. Back it up separately from /data; losing it makes the sealed account and config files unreadable.
  • Ports 80 and 443 are only needed for the optional custom block page and clash with Unraid's own web UI. They are off by default here; map them to free host ports (or give the container its own IP) only if you enable the block page.
  • Ports 853 and 8443 are only needed if you let clients talk to JustDNS over encrypted DNS (DoT/DoH).
  • On Unraid, update JustDNS from the Docker tab. The upstream project's one-click in-app updater is not used in this template.

JustDNS Unraid templates

Unraid Community Applications template for JustDNS, a self-hosted filtering DNS resolver with a company-level privacy dashboard.

What JustDNS does

JustDNS filters DNS for your whole network. It blocks ads, trackers and malware, and its privacy dashboard shows which companies your devices actually contact, with a per-device breakdown and a world map of where answers resolve. It ships encrypted upstreams (DNS-over-TLS) by default, per-device and per-group policies, DNSSEC validation, user accounts with roles and TOTP, and optional multi-node high availability.

Full documentation lives in the main repository: https://github.com/bonderaustriaAT/JustDNS.

Install on Unraid

  1. In Unraid, open the Apps tab and search for JustDNS.
  2. Install the template. The defaults expose DNS on port 53 and the dashboard on port 8080.
  3. Open the dashboard at http://YOUR-UNRAID-IP:8080 and finish the first-run wizard.
  4. Point your router's or devices' DNS at your Unraid server's IP.

Notes

  • The Keys volume (/keys) holds the at-rest encryption key. Back it up separately from the Data volume; losing it makes the sealed account and config files unreadable.
  • Ports 80/443 are only for the optional custom block page and clash with Unraid's own web UI. They are off by default; map them to free host ports, or give the container its own IP, only if you enable the block page.
  • Ports 853/8443 are only needed if clients talk to JustDNS over encrypted DNS (DoT/DoH).
  • Update JustDNS from the Unraid Docker tab. The project's in-app one-click updater is not used in this template.

Support

Issues and questions: https://github.com/bonderaustriaAT/JustDNS/issues

License

JustDNS and this template are licensed under AGPL-3.0-or-later. See LICENSE.

Media gallery

1 / 2

Categories

Related apps

Links

Details

Repository
ghcr.io/bonderaustriaat/justdns:latest
Last Updated2026-11-16
First Seen2026-11-16

Runtime arguments

Web UI
http://[IP]:[PORT:8080]
Network
bridge
Shell
sh
Privileged
false

Template configuration

Web UIPorttcp

HTTP port for the JustDNS dashboard.

Target
8080
Default
8080
Value
8080
DNS (UDP)Portudp

DNS service, UDP. Point your clients here.

Target
53
Default
53
Value
53
DNS (TCP)Porttcp

DNS service, TCP.

Target
53
Default
53
Value
53
DataPathrw

Persistent data: query log, lists, devices, settings.

Target
/data
Default
/mnt/user/appdata/justdns
Value
/mnt/user/appdata/justdns
KeysPathrw

At-rest encryption key, kept separate from Data on purpose. Back this up.

Target
/keys
Default
/mnt/user/appdata/justdns-keys
Value
/mnt/user/appdata/justdns-keys
DNS-over-TLS (DoT)Porttcp

Optional: encrypted client DNS over TLS. Enable in the dashboard first.

Target
853
Default
853
DNS-over-HTTPS (DoH)Porttcp

Optional: encrypted client DNS over HTTPS. Enable in the dashboard first.

Target
8443
Default
8443
Block page (HTTP)Porttcp

Optional: custom block page over HTTP. Clashes with Unraid's web UI on port 80; map to a free host port or give the container its own IP.

Target
80
Block page (HTTPS)Porttcp

Optional: custom block page over HTTPS. Clashes with Unraid's web UI on port 443; map to a free host port or give the container its own IP.

Target
443
DNSSECVariable

Validate DNSSEC on upstream answers.

Target
JUSTDNS_DNSSEC
Default
true
Value
true
Metrics token (Prometheus)Variable

Optional: set a token to enable the GET /metrics endpoint. Leave blank to keep it off.

Target
JUSTDNS_METRICS_TOKEN