2. Warda installieren

Wo man die Hardware kauft#

Was Sie brauchen:

• einen Raspberry Pi 5 oder einen Raspberry Pi 4 (die beiden Modelle, die Warda unterstützt);
• eine microSD-Karte: mindestens 16 GB; nehmen Sie eine 32-GB-Karte mit der Kennzeichnung A1 oder A2 einer bekannten Marke (SanDisk, Samsung, Kingston oder die offizielle Raspberry-Pi-Karte). Kaufen Sie sie im Shop der Marke, bei einem Raspberry-Pi-Händler oder bei einem Geschäft, das sie selbst verkauft — nicht bei einem unbekannten Händler eines Marktplatzes: Gefälschte Karten sind dort häufig;
• das offizielle Netzteil: USB-C 27 W für einen Raspberry Pi 5, USB-C 15 W für einen Raspberry Pi 4 (ein Handy-Ladegerät führt oft zu zufälligen Neustarts);
• ein Gehäuse, für einen Raspberry Pi 5 mit Kühlung (Lüfter oder Kühlkörper);
• ein Netzwerkkabel, lang genug bis zu Ihrem Router.

Geschäfte, geprüft am 11. Oktober 2026 (Preise und Lagerbestand ändern sich; Warda hat keinen Affiliate-Link und verdient nichts an diesen Geschäften):

• Deutschland: BerryBase, reichelt elektronik, buyzero.de, Welectron, Conrad.
• Österreich: Semaf Electronics, BerryBase Austria, reichelt (aus Deutschland), Conrad Austria, MediaMarkt Austria (Karten).
• Schweiz: Pi-Shop.ch, EducaWeb.ch, Galaxus, Digitec, Brack (Karten).

Andere Länder, und was jedes Geschäft verkauft: Where to buy the hardware (auf Englisch).

Mit einem Raspberry Pi (empfohlen)#

Sie benötigen einen Raspberry Pi 4 (oder neuer), sein Netzteil, eine microSD-Karte mit 16 GB oder mehr und ein Netzwerkkabel.

Die Bildschirmfotos dieses Abschnitts stammen aus Raspberry Pi Imager 2.0.11 mit französischer Oberfläche unter Windows: Die Wörter in Klammern sind dessen französische Beschriftungen. Die der folgenden Schritte zeigen Warda 0.7.8: Imager bietet die aktuelle Version an.

1. Installieren Sie Raspberry Pi Imager (2.0.2 oder neuer) auf Ihrem Computer. Laden Sie auf der Releases-Seite die Datei warda.rpi-imager-manifest herunter und öffnen Sie sie (Doppelklick): Imager startet mit Warda in seiner Liste der Systeme. Erster Schritt (Appareil): Wählen Sie Ihren Raspberry, Raspberry Pi 5 oder Raspberry Pi 4 (das Manifest gibt Imager diese beiden Modelle vor, nur sie stehen in der Liste), und gehen Sie mit der Schaltfläche unten rechts weiter (SUIVANT).

   

   

2. Zweiter Schritt (OS): Wählen Sie Warda <version>, ganz oben in der Liste. Imager lädt das Image selbst herunter und prüft dessen Fingerabdruck. Mit dem über das eigene Image (Utiliser image personnalisée) gewählten Image .img.xz bietet Imager die Anpassung nicht an.

   

3. Dritter Schritt (Stockage): Wählen Sie Ihre microSD-Karte. Lassen Sie das Kästchen angekreuzt, das die Systemlaufwerke ausschließt (Exclure les disques système): Die Laufwerke Ihres Computers werden nicht aufgeführt.

   

4. Die Anpassung (Personnalisation) beginnt mit dem Hostnamen (Nom d'hôte): Geben Sie dem Raspberry einen Namen in Ihrem Netzwerk, zum Beispiel warda-lab (nur Buchstaben, Ziffern und Bindestriche).

   

5. Standort (Localisation): Wählen Sie Ihre Hauptstadt, Ihre Zeitzone und Ihre Tastatur (Ville capitale, Fuseau horaire, Type de clavier).

   

6. Benutzer (Utilisateur): Legen Sie Ihren Benutzer an, mit seinem Benutzernamen (Nom d'utilisateur) und seinem Passwort, das zweimal einzugeben ist (Mot de passe, Confirmer le mot de passe).

   

7. WLAN (Wi-Fi): Lassen Sie alles leer und gehen Sie weiter (SUIVANT): Warda wird mit einem Netzwerkkabel angeschlossen.

   

8. Fernzugriff (Accès à distance): Damit später aus der Ferne geholfen werden kann, schalten Sie SSH ein (Activer SSH), wählen Sie die Anmeldung mit öffentlichem Schlüssel (Utiliser l'authentification par clé publique) und fügen Sie Ihren öffentlichen Schlüssel ein. Warda lehnt Passwörter über SSH ab: Mit einem Passwort allein lehnt SSH die Verbindung ab.

   

9. Imager zeigt die Zusammenfassung (Écriture): das Raspberry-Modell, das System und die Karte, danach die Anpassungen, die es anwenden wird (Personnalisation à appliquer). Prüfen Sie sie und starten Sie dann das Schreiben (ÉCRIRE).

   

   

10. Imager warnt, dass alles auf der Karte endgültig gelöscht wird. Prüfen Sie, dass Ihre Karte genannt ist, und bestätigen Sie (JE COMPRENDS, EFFACER ET ÉCRIRE).

    

11. Imager schreibt das Image: Ziehen Sie die Karte nicht ab.

    

12. Danach prüft es, was es geschrieben hat: Lassen Sie es fertig werden.

    

13. Wenn alles fertig ist (Écriture terminée !), führt Imager die angewendeten Anpassungen auf und hat die Karte ausgeworfen: Nehmen Sie sie heraus und schließen Sie Imager (TERMINER). Stecken Sie die Karte in den Raspberry, verbinden Sie ihn mit dem Netzwerkkabel mit Ihrem Router und schließen Sie dann den Strom an. Der erste Start dauert einige Minuten.

    

    

Mit der Image-Datei, ohne das Manifest. Der andere Weg, die Karte zu beschreiben: Laden Sie das Image warda_<version>_raspberrypi-arm64.img.xz von der Releases-Seite herunter und geben Sie Imager diese Datei selbst. Die beiden Wege unterscheiden sich in einem Punkt: Mit der Image-Datei hat Imager keinen Schritt für die Anpassung, während das Manifest Imager vor dem Schreiben den Hostnamen, den Benutzer, das WLAN und SSH einstellen lässt. Die Bildschirmfotos zeigen eine ältere, bereits entpackte Datei (warda_0.6.9_raspberrypi-arm64.img): Nehmen Sie die Datei des aktuellen Release.

1. Erster Schritt (Appareil): Wählen Sie Ihr Raspberry-Modell, Raspberry Pi 5 oder Raspberry Pi 4, und gehen Sie mit der Schaltfläche unten rechts weiter (SUIVANT).

   

   

2. Zweiter Schritt (OS): Gehen Sie ans Ende der Liste und wählen Sie ihren letzten Eintrag, das eigene Image (Utiliser image personnalisée), dann die heruntergeladene Datei von Warda.

   

3. Dritter Schritt (Stockage): Wählen Sie Ihre microSD-Karte. Lassen Sie das Kästchen angekreuzt, das die Systemlaufwerke ausschließt (Exclure les disques système): Die Laufwerke Ihres Computers werden nicht aufgeführt.

   

4. Der Schritt der Anpassung (Personnalisation) bleibt grau: Imager überspringt ihn und zeigt die Zusammenfassung (Écriture). Prüfen Sie das Raspberry-Modell, die Datei und die Karte, und starten Sie dann das Schreiben (ÉCRIRE).

   

   

5. Imager warnt, dass alles auf der Karte endgültig gelöscht wird. Prüfen Sie, dass Ihre Karte genannt ist, und bestätigen Sie (JE COMPRENDS, EFFACER ET ÉCRIRE).

   

6. Imager schreibt das Image: Ziehen Sie die Karte nicht ab.

   

7. Danach prüft es, was es geschrieben hat: Lassen Sie es fertig werden.

   

8. Wenn alles fertig ist (Écriture terminée !), hat Imager die Karte ausgeworfen: Nehmen Sie sie heraus und schließen Sie Imager (TERMINER).

   

   

Machen Sie danach weiter wie im letzten Schritt des ersten Weges: die Karte in den Raspberry, das Netzwerkkabel, der Strom.

Auf einem Debian- oder Ubuntu-Rechner#

Laden Sie das Paket für Ihren Rechner herunter (amd64 für einen PC, arm64 für einen bereits installierten Raspberry Pi), dann:

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

Die Ports 53, 80 und 443 müssen frei sein: Beenden Sie zuerst einen anderen Pi-hole, dnsmasq oder Webserver auf demselben Rechner.

Unter Fedora, RHEL, Rocky Linux oder AlmaLinux#

Laden Sie das rpm-Paket für Ihren Rechner herunter (x86_64 für einen PC, aarch64 für einen ARM-Rechner), dann:

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

Das Paket öffnet die Ports von Warda in firewalld (Dienst warda), und Warda aktualisiert sich selbst, wie mit dem Debian-Paket. Die Ports 53, 80 und 443 müssen frei sein: Unter Fedora belegt systemd-resolved oft den Port 53; tragen Sie DNSStubListener=no in /etc/systemd/resolved.conf ein und führen Sie dann sudo systemctl restart systemd-resolved aus.

Mit Docker#

Auf einem Raspberry Pi 4 oder neuer mit einem 64-Bit-System, oder auf jedem 64-Bit-Rechner (PC oder ARM) mit Docker und seinem Compose-Plugin. Jede Version von Warda kommt mit einer fertigen docker-compose.yml, die genau diese Version installiert. In einem leeren Ordner:

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

Dieselbe Datei liegt auch im Stammverzeichnis des Repositorys der Versionen: immer die der neuesten Version.

Warda nutzt das Netzwerk des Rechners direkt: Die Ports 53 (DNS), 80 und 443 (Weboberfläche) müssen frei sein.

Ein Reverse Proxy (Traefik, nginx, Caddy) oder ein NAS belegt schon die Ports 80 und 443? Ändern Sie vor docker compose up -d diese beiden Zeilen der docker-compose.yml (unter environment:) und öffnen Sie Warda dann unter http://<Adresse des Rechners>:8080:

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

Port 53 ist belegt? Er lässt sich nicht verlegen: Die Geräte fragen nur diesen Port. Stoppen Sie den anderen DNS-Server (Pi-hole, AdGuard Home, dnsmasq). Unter Debian oder Ubuntu ist es oft systemd-resolved: Tragen Sie DNSStubListener=no in /etc/systemd/resolved.conf ein und führen Sie dann sudo systemctl restart systemd-resolved aus.

Danach:

docker logs warda
docker exec warda warda setup-info

Der erste Befehl zeigt die zu öffnende Adresse (mit ihrem Port), der zweite das Standardpasswort. Ist ein Port schon belegt, hält Warda an, und sein Protokoll nennt den Port, das Programm, das ihn vermutlich hält, und die Zeile der Datei, die zu ändern ist; Docker startet es etwa einmal pro Minute neu, bis der Port frei ist. Das Protokoll des Containers bleibt klein (3 Dateien zu 10 MB).

Zum Aktualisieren tragen Sie die Nummer der neuen Version in die Zeile image: der Datei ein, dann:

docker compose pull && docker compose up -d

Die Datei der neuen Version erneut herunterzuladen geht auch, ersetzt aber die Ports, die Sie geändert haben. Die Ports 80 und 443 zu verlegen teilt nur den Rechner mit Ihrem Reverse Proxy: Veröffentlichen Sie Warda nie darüber im Internet (Kapitel 12).

Erste Anmeldung#

1. Öffnen Sie von einem Computer des Netzwerks aus http://warda (oder http://ADDRESS-OF-THE-BOX). Das Zertifikat ist selbstsigniert: Akzeptieren Sie es einmalig.

2. Melden Sie sich innerhalb der Stunde nach dem Start mit dem Konto admin und dem Standardpasswort Ward@-MM-YYYY an, wobei MM-YYYY der Monat der Version ist (zum Beispiel Ward@-09-2026). Danach stecken Sie die Box aus und wieder ein. Dieses Passwort ist öffentlich: Solange die Box nicht installiert ist, könnte jeder in Ihrem Netzwerk sie an Ihrer Stelle installieren. Installieren Sie sie gleich nach ihrem ersten Start, von einem Computer Ihres eigenen Netzwerks aus (Kapitel 12).

3. Der Installationsassistent öffnet sich, Schritt für Schritt: ein neues Passwort für admin (das Notfallkonto: bewahren Sie es sicher auf), Ihr eigenes Konto, dann Ihre Box (Kapitel 3) und Ihr Haushalt (Kapitel 4).

   Der erste Schritt zeigt die Nutzungsbedingungen, die Sie lesen und akzeptieren (eine Zusammenfassung und der Link zum vollständigen Text); dort wird auch die anonyme tägliche Zählung gezeigt, eingeschaltet, und Sie können sie abwählen.

Später, sobald die Box ihren Namen und ein Zertifikat hat, dem die Browser vertrauen (Kapitel 3), führt http://warda von selbst zu https:// gefolgt von diesem Namen, und der Browser zeigt keine Warnung mehr (ab Warda 0.7.10).

Ersetzen Sie eine alte Box? Auf dem ersten Bildschirm des Assistenten bringt Ich habe eine Sicherung von Warda alle Ihre Konten und Einstellungen zurück (Kapitel 6).

Beim Schritt des Netzwerks zeigt der Assistent auch das Land der Box und bietet, wenn die Zeitzone der Box nicht die Ihres Browsers ist, Europe/Paris verwenden an (Ihre Zone): Internetzeiten und Berichte richten sich nach der Uhrzeit der Box. Das Raspberry-Pi-Image startet mit UTC: Hier stellen Sie sie ein.