Warda-DNSDocs Warda: from ward — to protect, guardian
v0.9.3

7. Troubleshooting

In short

No site at all: check that the box is on and reachable, systemctl status warda, journalctl -u warda. One broken site: "Something is broken". Lost password: sudo warda reset-password NAME. Diagnostic to send: System → Download a diagnostic (no browsing data).

No site opens on the network any more. The box may be off or unplugged. Check its power and its cable. Meanwhile, set the DNS of the router back to its default: the Internet works again, without protection. If Warda gives the addresses of the network (DHCP), turn the DHCP server of the box on again: the devices keep their address for a day.

One site or one application no longer works. Use Something is broken on that device (chapter 5).

Forgotten password. Another administrator gives you a temporary one from Administration → Access to Warda. Otherwise, on the box: sudo warda reset-password YOUR-NAME. For the emergency account: sudo warda reset-password admin.

The page of Warda no longer opens. Try http://ADDRESS-OF-THE-BOX instead of http://warda, from a device on the same network. From Warda 0.7.10, http://warda may send you to https:// followed by the name of the box: if your browser cannot reach that name (its own secure DNS, a DNS that is not Warda), run sudo warda https-redirect off on the box. Warda then answers again at the address typed.

Warda restarted and you do not know why. Look at the mark on the chart of the dashboard, or at Administration → Activity log (service.start, with its reason). On the box (package or Raspberry Pi image), this command lists the starts and the stops of the last 7 days; with Docker, read docker logs warda:

sh
sudo journalctl -u warda.service -u warda-update.service -u warda-system.service -u warda-rollback.service --since "-7 days" -o short-iso --no-pager | grep -E "systemd\[1\]|starting warda|shutting down|restarting|start of Warda|fatal error"

The query log shows "Unknown local name". It is normal: a device asked for a name of the local network that no device has, and Warda keeps it from the Internet (chapter 5). If your box does know this name (a device it named itself, its local zone), the detail of the row offers send its local zone to the box, in the settings: in Settings, part Local network, give the zone and the address of the box, and it answers those names.

Checking the network. Network → Tools gathers small tools run from the box: ping and traceroute (with the country of each router), DNS test (does Warda block this name, and why?), port test (does the box let encrypted DNS through, port 853?), Wake-on-LAN, "who uses this address?" (two machines on the same address) and DHCP test. A device that left the network is never removed: it shows as "Not available", with the last time it was seen.

Asking for help. In System, Download a diagnostic makes a file that describes the state of Warda and its last errors, without any name of a site visited nor any secret: attach it to your request. Send to the Warda team sends it for you and gives a code (WD-…) to give on support.warda-dns.com; it is kept 30 days.

Both buttons are in the card Diagnostic and support of System.