2. Warda installeren

Waar u de hardware koopt#

Wat u nodig hebt:

• een Raspberry Pi 5 of een Raspberry Pi 4 (de twee modellen die Warda ondersteunt);
• een microSD-kaart: minstens 16 GB; neem een kaart van 32 GB met het teken A1 of A2, van een bekend merk (SanDisk, Samsung, Kingston, of de officiële Raspberry Pi-kaart). Koop ze in de winkel van het merk, bij een Raspberry Pi-verkoper of in een winkel die ze zelf verkoopt — niet bij een onbekende verkoper op een marktplaats: valse kaarten zijn daar gewoon;
• de officiële voeding: USB-C 27 W voor een Raspberry Pi 5, USB-C 15 W voor een Raspberry Pi 4 (een telefoonlader veroorzaakt vaak willekeurige herstarts);
• een behuizing, met koeling (ventilator of koellichaam) voor een Raspberry Pi 5;
• een netwerkkabel die lang genoeg is tot uw router.

Winkels, gecontroleerd op 11 oktober 2026 (prijzen en voorraad veranderen; Warda heeft geen affiliatelink en verdient niets aan deze winkels):

• Nederland: Kiwi Electronics, Elektronica Voor Jou, Raspberry Store NL, Elektor, Coolblue (kaarten).
• België: MC Hobby, Rato Education, Kiwi Electronics (vanuit Nederland), Coolblue en MediaMarkt (kaarten).

Andere landen, en wat elke winkel verkoopt: Where to buy the hardware (in het Engels).

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.

De schermafbeeldingen van deze sectie komen uit Raspberry Pi Imager 2.0.11 met de interface in het Frans, onder Windows: de woorden tussen haakjes zijn de Franse labels ervan. Die van de stappen hieronder tonen Warda 0.7.8: Imager biedt de huidige versie aan.

1. Installeer Raspberry Pi Imager (2.0.2 of later) op uw computer. Download op de releasepagina het bestand warda.rpi-imager-manifest en open het (dubbelklik): Imager start op met Warda in zijn lijst van systemen. Eerste stap (Appareil): kies uw Raspberry, Raspberry Pi 5 of Raspberry Pi 4 (het manifest geeft Imager deze twee modellen, de enige in de lijst), en ga verder met de knop rechtsonder (SUIVANT).

   

   

2. Tweede stap (OS): kies Warda <version>, bovenaan in de lijst. Imager downloadt de image zelf en controleert de vingerafdruk ervan. Met de image .img.xz gekozen via de eigen image (Utiliser image personnalisée) biedt Imager de aanpassing niet aan.

   

3. Derde stap (Stockage): kies uw microSD-kaart. Laat het vakje dat de systeemschijven uitsluit aangevinkt (Exclure les disques système): de schijven van uw computer staan niet in de lijst.

   

4. De aanpassing (Personnalisation) begint met de hostnaam (Nom d'hôte): geef de Raspberry een naam in uw netwerk, bijvoorbeeld warda-lab (alleen letters, cijfers en koppeltekens).

   

5. Locatie (Localisation): kies uw hoofdstad, uw tijdzone en uw toetsenbord (Ville capitale, Fuseau horaire, Type de clavier).

   

6. Gebruiker (Utilisateur): maak uw gebruiker aan, met zijn gebruikersnaam (Nom d'utilisateur) en zijn wachtwoord, dat u twee keer invoert (Mot de passe, Confirmer le mot de passe).

   

7. Wifi (Wi-Fi): laat alles leeg en ga verder (SUIVANT): Warda wordt met een netwerkkabel aangesloten.

   

8. Toegang op afstand (Accès à distance): om op afstand te kunnen helpen, schakelt u SSH in (Activer SSH), kiest u de authenticatie met publieke sleutel (Utiliser l'authentification par clé publique) en plakt u uw publieke sleutel. Warda weigert wachtwoorden via SSH: met alleen een wachtwoord weigert SSH de verbinding.

   

9. Imager toont het overzicht (Écriture): het model Raspberry, het systeem en de kaart, en daarna de aanpassingen die het gaat toepassen (Personnalisation à appliquer). Controleer ze en start dan het schrijven (ÉCRIRE).

   

   

10. Imager waarschuwt dat alles op de kaart voorgoed wordt gewist. Controleer of uw kaart wordt genoemd en bevestig (JE COMPRENDS, EFFACER ET ÉCRIRE).

    

11. Imager schrijft de image: koppel de kaart niet los.

    

12. Daarna controleert het wat het heeft geschreven: laat het afmaken.

    

13. Wanneer alles klaar is (Écriture terminée !), somt Imager de toegepaste aanpassingen op en heeft het de kaart uitgeworpen: neem haar uit en sluit Imager (TERMINER). 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.

    

    

Met het imagebestand, zonder het manifest. De andere manier om de kaart te schrijven: download de image warda_<version>_raspberrypi-arm64.img.xz op de releasepagina en geef dat bestand zelf aan Imager. De twee manieren verschillen op één punt: met het imagebestand heeft Imager geen stap voor de aanpassing, terwijl het manifest Imager de hostnaam, de gebruiker, de wifi en SSH laat instellen voordat het schrijft. De schermafbeeldingen tonen een ouder bestand, al uitgepakt (warda_0.6.9_raspberrypi-arm64.img): neem het bestand van de huidige release.

1. Eerste stap (Appareil): kies uw model Raspberry, Raspberry Pi 5 of Raspberry Pi 4, en ga verder met de knop rechtsonder (SUIVANT).

   

   

2. Tweede stap (OS): ga naar het einde van de lijst en kies het laatste item, de eigen image (Utiliser image personnalisée), en daarna het bestand van Warda dat u hebt gedownload.

   

3. Derde stap (Stockage): kies uw microSD-kaart. Laat het vakje dat de systeemschijven uitsluit aangevinkt (Exclure les disques système): de schijven van uw computer staan niet in de lijst.

   

4. De stap van de aanpassing (Personnalisation) blijft grijs: Imager slaat hem over en toont het overzicht (Écriture). Controleer het model Raspberry, het bestand en de kaart, en start dan het schrijven (ÉCRIRE).

   

   

5. Imager waarschuwt dat alles op de kaart voorgoed wordt gewist. Controleer of uw kaart wordt genoemd en bevestig (JE COMPRENDS, EFFACER ET ÉCRIRE).

   

6. Imager schrijft de image: koppel de kaart niet los.

   

7. Daarna controleert het wat het heeft geschreven: laat het afmaken.

   

8. Wanneer alles klaar is (Écriture terminée !), heeft Imager de kaart uitgeworpen: neem haar uit en sluit Imager (TERMINER).

   

   

Ga daarna verder zoals in de laatste stap van de eerste manier: de kaart in de Raspberry, de netwerkkabel, de voeding.

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:

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.

Op Fedora, RHEL, Rocky Linux of AlmaLinux#

Download het rpm-pakket van uw machine (x86_64 voor een pc, aarch64 voor een ARM-machine), en dan:

sudo dnf install ./warda-<version>-1.x86_64.rpm

Het pakket opent de poorten van Warda in firewalld (service warda), en Warda werkt zichzelf bij, net als met het Debian-pakket. Poorten 53, 80 en 443 moeten vrij zijn: op Fedora bezet systemd-resolved vaak poort 53; zet DNSStubListener=no in /etc/systemd/resolved.conf en voer daarna sudo systemctl restart systemd-resolved uit.

Met Docker#

Op een Raspberry Pi 4 of later met een 64-bitsysteem, of op elke 64-bitmachine (pc of ARM) met Docker en zijn Compose-plug-in. Elke versie van Warda komt met een kant-en-klare docker-compose.yml, die die versie installeert. In een lege map:

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

Hetzelfde bestand staat ook in de hoofdmap van de repository van de versies: altijd dat van de nieuwste versie.

Warda gebruikt het netwerk van de machine rechtstreeks: de poorten 53 (DNS), 80 en 443 (webinterface) moeten vrij zijn.

Gebruikt een reverse proxy (Traefik, nginx, Caddy) of een NAS de poorten 80 en 443 al? Wijzig vóór docker compose up -d deze twee regels van docker-compose.yml (onder environment:) en open Warda daarna op http://<adres van de machine>:8080:

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

Is poort 53 bezet? Die kan niet verhuizen: de apparaten vragen alleen die poort. Stop de andere DNS-server (Pi-hole, AdGuard Home, dnsmasq). Op Debian of Ubuntu is het vaak systemd-resolved: schrijf DNSStubListener=no in /etc/systemd/resolved.conf en voer daarna sudo systemctl restart systemd-resolved uit.

Daarna:

docker logs warda
docker exec warda warda setup-info

De eerste opdracht toont het adres dat u moet openen (met zijn poort), de tweede het standaardwachtwoord. Is een poort al in gebruik, dan stopt Warda en zijn logboek noemt de poort, het programma dat hem waarschijnlijk bezet en de regel van het bestand die u moet wijzigen; Docker start het opnieuw, ongeveer één keer per minuut, tot de poort vrij is. Het logboek van de container blijft klein (3 bestanden van 10 MB).

Om bij te werken schrijft u het nummer van de nieuwe versie op de regel image: van het bestand, en daarna:

docker compose pull && docker compose up -d

Het bestand van de nieuwe versie opnieuw downloaden werkt ook, maar het vervangt de poorten die u hebt gewijzigd. De poorten 80 en 443 verplaatsen deelt alleen de machine met uw reverse proxy: publiceer Warda nooit via hem op het internet (hoofdstuk 12).

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. Dit wachtwoord is openbaar: zolang de box niet geïnstalleerd is, kan iedereen op uw netwerk hem in uw plaats installeren. Installeer hem meteen na zijn eerste start, vanaf een computer van uw eigen netwerk (hoofdstuk 12).

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.

Later, zodra het kastje zijn naam heeft en een certificaat dat de browsers vertrouwen (hoofdstuk 3), leidt http://warda vanzelf naar https:// gevolgd door die naam, en toont de browser geen waarschuwing meer (vanaf Warda 0.7.10).

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).

Bij de stap van het netwerk toont de assistent ook het land van het kastje en, als de tijdzone van het kastje niet die van uw browser is, stelt hij Europe/Paris gebruiken voor (uw zone): de internettijden en de rapporten volgen de tijd van het kastje. De Raspberry Pi-image start in UTC: stel het hier in.