2. Installer Warda

Où acheter le matériel#

Ce qu'il faut acheter :

• un Raspberry Pi 5 ou un Raspberry Pi 4 (les deux modèles que Warda prend en charge) ;
• une carte microSD : 16 Go au minimum ; prenez une carte de 32 Go marquée A1 ou A2, d'une marque connue (SanDisk, Samsung, Kingston, ou la carte officielle Raspberry Pi). Achetez-la sur la boutique de la marque, chez un revendeur Raspberry Pi ou dans un magasin qui la vend lui-même — pas auprès d'un vendeur inconnu d'une place de marché : les fausses cartes y sont courantes ;
• l'alimentation officielle : USB-C 27 W pour un Raspberry Pi 5, USB-C 15 W pour un Raspberry Pi 4 (un chargeur de téléphone provoque souvent des redémarrages au hasard) ;
• un boîtier, ventilé (ventilateur ou dissipateur) pour un Raspberry Pi 5 ;
• un câble réseau assez long pour aller jusqu'à votre box.

Des boutiques, vérifiées le 11 octobre 2026 (les prix et les stocks changent ; Warda n'a aucun lien d'affiliation et ne gagne rien sur ces boutiques) :

• France : Kubii, ES France, LDLC, Fnac et Boulanger (cartes).
• Belgique : MC Hobby, Rato Education, Kiwi Electronics (Pays-Bas, livre en Belgique), Coolblue et MediaMarkt (cartes).
• Suisse : Pi-Shop.ch, EducaWeb.ch, Galaxus, Digitec et Brack (cartes).
• Luxembourg : electronic-shop.lu, LDLC Luxembourg, et, depuis la France et l'Allemagne, Kubii et reichelt.

Autres pays, et ce que vend chaque boutique : Where to buy the hardware (en anglais).

Avec un Raspberry Pi (recommandé)#

Il vous faut un Raspberry Pi 4 (ou plus récent), son alimentation, une carte microSD de 16 Go ou plus et un câble réseau.

Les captures de cette section viennent de Raspberry Pi Imager 2.0.11, sous Windows. Celles des étapes ci-dessous montrent Warda 0.7.8 : Imager propose la version en cours.

1. Installez Raspberry Pi Imager (2.0.2 ou plus récent) sur votre ordinateur. Sur la page des versions, téléchargez le fichier warda.rpi-imager-manifest et ouvrez-le (double-clic) : Imager démarre avec Warda dans la liste des systèmes. Étape Appareil : choisissez votre Raspberry, Raspberry Pi 5 ou Raspberry Pi 4 (le manifeste donne ces deux modèles à Imager, les seuls proposés), puis SUIVANT.

   

   

2. Étape OS : choisissez Warda <version>, en haut de la liste. Imager télécharge l'image seul et vérifie son empreinte. Avec l'image .img.xz choisie par Utiliser image personnalisée, Imager ne propose pas la personnalisation.

   

3. Étape Stockage : choisissez votre carte microSD. Laissez Exclure les disques système coché : les disques de votre ordinateur ne sont pas proposés.

   

4. L'étape Personnalisation commence par le Nom d'hôte : donnez un nom au Raspberry sur votre réseau, par exemple warda-lab (lettres, chiffres et tirets seulement).

   

5. Localisation : choisissez votre Ville capitale, votre Fuseau horaire et votre Type de clavier.

   

6. Utilisateur : créez votre utilisateur, avec son Nom d'utilisateur et son Mot de passe, à saisir deux fois (Confirmer le mot de passe).

   

7. Wi-Fi : laissez tout vide et passez à la suite (SUIVANT) : Warda se branche avec un câble réseau.

   

8. Accès à distance : si vous voulez pouvoir intervenir à distance, activez SSH (Activer SSH), choisissez Utiliser l'authentification par clé publique et collez votre clé publique. Warda refuse les mots de passe en SSH : avec un mot de passe seul, SSH refusera la connexion.

   

9. Imager affiche le résumé (Écriture) : le modèle de Raspberry, le système et la carte, puis les personnalisations qu'il va appliquer (Personnalisation à appliquer). Vérifiez-les, puis ÉCRIRE.

   

   

10. Imager prévient que toutes les données de la carte vont être effacées, définitivement. Vérifiez qu'il nomme bien votre carte, puis JE COMPRENDS, EFFACER ET ÉCRIRE.

    

11. Imager écrit l'image : ne débranchez pas la carte.

    

12. Puis il vérifie ce qu'il a écrit : laissez-le terminer.

    

13. Quand tout est fini (Écriture terminée !), Imager liste les personnalisations appliquées et a éjecté la carte : retirez-la, puis TERMINER. Mettez la carte dans le Raspberry, branchez-le à votre box avec le câble réseau, puis branchez l'alimentation. Le premier démarrage dure quelques minutes.

    

    

Avec le fichier image, sans le fichier manifeste. L'autre façon d'écrire la carte : téléchargez l'image warda_<version>_raspberrypi-arm64.img.xz sur la page des versions et donnez vous-même ce fichier à Imager. Une seule différence entre les deux façons : avec le fichier image, Imager n'a pas d'étape de personnalisation, alors que le manifeste lui permet de régler le nom de la machine, l'utilisateur, le Wi-Fi et SSH avant d'écrire. Les captures montrent un fichier plus ancien, déjà décompressé (warda_0.6.9_raspberrypi-arm64.img) : prenez celui de la version en cours.

1. Étape Appareil : choisissez votre modèle de Raspberry, Raspberry Pi 5 ou Raspberry Pi 4, puis SUIVANT.

   

   

2. Étape OS : descendez tout en bas de la liste et choisissez Utiliser image personnalisée, puis le fichier de Warda que vous avez téléchargé.

   

3. Étape Stockage : choisissez votre carte microSD. Laissez Exclure les disques système coché : les disques de votre ordinateur ne sont pas proposés.

   

4. L'étape Personnalisation reste grisée : Imager la saute et affiche le résumé (Écriture). Vérifiez le modèle de Raspberry, le fichier et la carte, puis ÉCRIRE.

   

   

5. Imager prévient que toutes les données de la carte vont être effacées, définitivement. Vérifiez qu'il nomme bien votre carte, puis JE COMPRENDS, EFFACER ET ÉCRIRE.

   

6. Imager écrit l'image : ne débranchez pas la carte.

   

7. Puis il vérifie ce qu'il a écrit : laissez-le terminer.

   

8. Quand tout est fini (Écriture terminée !), Imager a éjecté la carte : retirez-la, puis TERMINER.

   

   

Poursuivez ensuite comme à la dernière étape de la première façon : la carte dans le Raspberry, le câble réseau, l'alimentation.

Sur une machine Debian ou Ubuntu#

Téléchargez le paquet de votre machine (amd64 pour un PC, arm64 pour un Raspberry Pi déjà installé), puis :

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

Les ports 53, 80 et 443 doivent être libres : arrêtez d'abord un autre Pi-hole, dnsmasq ou serveur web sur la même machine.

Sous Fedora, RHEL, Rocky Linux ou AlmaLinux#

Téléchargez le paquet rpm de votre machine (x86_64 pour un PC, aarch64 pour une machine ARM), puis :

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

Le paquet ouvre les ports de Warda dans firewalld (service warda), et Warda se met à jour tout seul, comme avec le paquet Debian. Les ports 53, 80 et 443 doivent être libres : sous Fedora, systemd-resolved occupe souvent le port 53 ; écrivez DNSStubListener=no dans /etc/systemd/resolved.conf, puis lancez sudo systemctl restart systemd-resolved.

Avec Docker#

Sur un Raspberry Pi 4 ou plus récent avec un système 64 bits, ou sur n'importe quelle machine 64 bits (PC ou ARM) avec Docker et son extension Compose. Chaque version de Warda est livrée avec un docker-compose.yml prêt à l'emploi, qui installe cette version. Dans un dossier vide :

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

Le même fichier se trouve aussi à la racine du dépôt des versions : toujours celui de la dernière version.

Warda utilise directement le réseau de la machine : les ports 53 (DNS), 80 et 443 (interface web) doivent être libres.

Un reverse proxy (Traefik, nginx, Caddy) ou un NAS utilise déjà les ports 80 et 443 ? Avant docker compose up -d, changez ces deux lignes de docker-compose.yml (sous environment:), puis ouvrez Warda à l'adresse http://<adresse de la machine>:8080 :

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

Le port 53 est pris ? Il ne peut pas changer : les appareils ne demandent que ce port. Arrêtez l'autre serveur DNS (Pi-hole, AdGuard Home, dnsmasq). Sur Debian ou Ubuntu, c'est souvent systemd-resolved : écrivez DNSStubListener=no dans /etc/systemd/resolved.conf, puis lancez sudo systemctl restart systemd-resolved.

Ensuite :

docker logs warda
docker exec warda warda setup-info

La première commande donne l'adresse à ouvrir (avec son port), la seconde le mot de passe par défaut. Si un port est déjà utilisé, Warda s'arrête et son journal indique le port, le programme qui le tient sans doute et la ligne du fichier à changer ; Docker le relance, environ une fois par minute, jusqu'à ce que le port soit libre. Le journal du conteneur reste petit (3 fichiers de 10 Mo).

Pour mettre à jour, écrivez le numéro de la nouvelle version sur la ligne image: du fichier, puis :

docker compose pull && docker compose up -d

Télécharger à nouveau le fichier de la nouvelle version marche aussi, mais il remplace les ports que vous avez changés. Déplacer les ports 80 et 443 ne fait que partager la machine avec votre reverse proxy : ne publiez jamais Warda sur Internet à travers lui (chapitre 12).

Première connexion#

1. Depuis un ordinateur du réseau, ouvrez http://warda (ou http://ADRESSE-DU-BOÎTIER). Le certificat est auto-signé : acceptez-le une fois.

2. Connectez-vous dans l'heure qui suit le démarrage avec le compte admin et le mot de passe par défaut Ward@-MM-AAAA, où MM-AAAA est le mois de la version (par exemple Ward@-09-2026). Passé ce délai, débranchez et rebranchez le boîtier. Ce mot de passe est public : tant que le boîtier n'est pas installé, n'importe qui sur votre réseau pourrait l'installer à votre place. Installez-le juste après son premier démarrage, depuis un ordinateur de votre propre réseau (chapitre 12).

3. L'assistant d'installation s'ouvre, une étape à la fois : un nouveau mot de passe pour admin (le compte de secours : gardez-le en lieu sûr), votre propre compte, puis votre box (chapitre 3) et votre foyer (chapitre 4).

   La première étape présente les conditions d'utilisation, à lire et à accepter (un résumé et le lien vers le texte complet) ; le comptage anonyme quotidien y est montré aussi, activé, et vous pouvez le décocher.

Plus tard, quand le boîtier a son nom et un certificat reconnu par les navigateurs (chapitre 3), http://warda mène de lui-même à https:// suivi de ce nom, et le navigateur n'affiche plus d'avertissement (à partir de Warda 0.7.10).

Vous remplacez un ancien boîtier ? Sur le premier écran de l'assistant, J'ai une sauvegarde de Warda reprend tous vos comptes et réglages (chapitre 6).

À l'étape du réseau, l'assistant indique aussi le pays du boîtier et, quand le fuseau horaire du boîtier diffère de celui de votre navigateur, propose Utiliser Europe/Paris (votre fuseau) : les horaires d'Internet et les rapports suivent l'heure du boîtier. L'image Raspberry Pi démarre en UTC : c'est ici qu'on la règle.