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.
Readme
View on GitHubJustDNS 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
- In Unraid, open the Apps tab and search for JustDNS.
- Install the template. The defaults expose DNS on port 53 and the dashboard on port 8080.
- Open the dashboard at
http://YOUR-UNRAID-IP:8080and finish the first-run wizard. - 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 / 2Categories
Related apps
Explore more like this
Explore allLinks
Details
ghcr.io/bonderaustriaat/justdns:latestRuntime arguments
- Web UI
http://[IP]:[PORT:8080]- Network
bridge- Shell
sh- Privileged
- false
Template configuration
HTTP port for the JustDNS dashboard.
- Target
- 8080
- Default
- 8080
- Value
- 8080
DNS service, UDP. Point your clients here.
- Target
- 53
- Default
- 53
- Value
- 53
DNS service, TCP.
- Target
- 53
- Default
- 53
- Value
- 53
Persistent data: query log, lists, devices, settings.
- Target
- /data
- Default
- /mnt/user/appdata/justdns
- Value
- /mnt/user/appdata/justdns
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
Optional: encrypted client DNS over TLS. Enable in the dashboard first.
- Target
- 853
- Default
- 853
Optional: encrypted client DNS over HTTPS. Enable in the dashboard first.
- Target
- 8443
- Default
- 8443
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
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
Validate DNSSEC on upstream answers.
- Target
- JUSTDNS_DNSSEC
- Default
- true
- Value
- true
Optional: set a token to enable the GET /metrics endpoint. Leave blank to keep it off.
- Target
- JUSTDNS_METRICS_TOKEN