Warda-DNSDocs
NL
Menu

2. Warda installeren

In het kort

Raspberry Pi 4 of later: bestand warda.rpi-imager-manifest, geopend in Raspberry Pi Imager 2.x (biedt de image van Warda met de aanpassing aan; SSH alleen met sleutel). Debian/Ubuntu 64-bit: sudo apt install ./warda_<version>_<arch>.deb. Docker: image warda-dns/warda, hostnetwerk, --restart unless-stopped. Poorten 53, 80 en 443 vrij. Daarna http://<address> binnen het uur, account admin, wachtwoord Ward@-MM-YYYY (maand van de versie).

Met een Raspberry Pi (aanbevolen)#

U hebt een Raspberry Pi 4 (of later) nodig, de voeding ervan, een microSD-kaart van 16 GB of meer en een netwerkkabel.

  1. Installeer Raspberry Pi Imager (2.0.2 of later) op uw computer.
  2. Download op de releasepagina het bestand warda.rpi-imager-manifest en open het (dubbelklik): Imager start op met Warda in zijn lijst van systemen. Kies uw Raspberry, Warda <version>, en daarna uw kaart. Imager download de image zelf en controleert de vingerafdruk ervan. Met de image .img.xz gekozen via "Use custom" biedt Imager de aanpassing niet aan.
  3. Maak in de instellingen van Imager uw gebruiker aan. Om op afstand te kunnen helpen, schakelt u SSH in met "Allow public-key authentication only" en uw publieke sleutel: Warda weigert wachtwoorden via SSH.
  4. Plaats de kaart in de Raspberry, sluit hem met de netwerkkabel aan op uw router, en steek daarna de voeding in het stopcontact. De eerste start duurt enkele minuten.

Op een Debian- of Ubuntu-machine#

Download het pakket van uw machine (amd64 voor een pc, arm64 voor een reeds geïnstalleerde Raspberry Pi), en dan:

sh
sudo apt install ./warda_<version>_amd64.deb

Poorten 53, 80 en 443 moeten vrij zijn: stop eerst een andere Pi-hole, dnsmasq of webserver op dezelfde machine.

Met Docker#

sh
docker run -d --name warda --restart unless-stopped --network host \
  --user 0:0 --cap-drop ALL --cap-add NET_BIND_SERVICE \
  --cap-add NET_RAW --cap-add DAC_OVERRIDE --cap-add FOWNER \
  -e TZ=Europe/Paris -v warda-data:/var/lib/warda \
  <registry>/warda-dns/warda:latest

Het bestand packaging/docker-compose.yml van het project geeft een volledig, gehard voorbeeld.

Eerste aanmelding#

  1. Open vanaf een computer op het netwerk http://warda (of http://ADDRESS-OF-THE-BOX). Het certificaat is zelfondertekend: accepteer het eenmalig.

  2. Meld u aan binnen het uur na de start met het account admin en het standaardwachtwoord Ward@-MM-YYYY, waarbij MM-YYYY de maand van de versie is (bijvoorbeeld Ward@-09-2026). Daarna koppelt u de box los en sluit u hem weer aan.

  3. De installatie-assistent opent, stap voor stap: een nieuw wachtwoord voor admin (het noodaccount: bewaar het op een veilige plek), uw eigen account, dan uw box (hoofdstuk 3) en uw huishouden (hoofdstuk 4).

    De eerste stap toont de gebruiksvoorwaarden, om te lezen en te aanvaarden (een samenvatting en de link naar de volledige tekst); de anonieme dagelijkse telling staat daar ook, aan, en u kunt ze uitvinken.

Vervangt u een oude box? Op het eerste scherm van de assistent brengt Ik heb een back-up van Warda al uw accounts en instellingen terug (hoofdstuk 6).