Warda-DNS Warda: from ward — to protect, guardian
v0.9.10

Install Warda with Docker

On a Raspberry Pi 4 or later with a 64-bit system, or on any 64-bit machine with Docker and its Compose plugin. Each release comes with a ready docker-compose.yml.

01Start Warda

In an empty folder, download the file of the latest release and start it. Warda uses the network of the machine: ports 53 (DNS), 80 and 443 (interface) must be free.

bash
curl -fsSLO https://github.com/warda-dns/Releases/releases/latest/download/docker-compose.yml
docker compose up -d

02Ports 80 and 443 already taken

A reverse proxy (Traefik, nginx, Caddy) or a NAS already holds them? Before starting, change these two lines under environment:, then open Warda at http://<address>:8080. Never publish Warda on the Internet through that proxy.

Port 53 cannot move: the devices only ask that port. Stop the other DNS server; on Debian or Ubuntu it is often systemd-resolved (DNSStubListener=no in /etc/systemd/resolved.conf, then restart it).

yaml
      WARDA_HTTP_LISTEN: ":8080"
      WARDA_HTTPS_LISTEN: ":8443"

03The address and the password

The first command shows the address to open, the second the default password, to use within the hour after the start. If a port is in use, the log names it, with the program that probably holds it.

bash
docker logs warda
docker exec warda warda setup-info

04Update

With Docker, Warda installs nothing by itself: every 6 hours it checks for a new version signed by its publisher and shows it in System. Write the new version in the line image: of the file, then pull and restart. The nightly copy of the backups to a USB drive is not done in Docker.

bash
docker compose pull && docker compose up -d

Updates and backups

See also

Still stuck?

Tell us what happened, with the version of Warda: the form of the beta page reaches the team, or write to [email protected]. A diagnostic of System (Download a diagnostic, without any site visited) helps a lot.

Report a problemWrite to us