2. Installare Warda

Dove comprare l'hardware#

Cosa comprare:

• un Raspberry Pi 5 o un Raspberry Pi 4 (i due modelli che Warda supporta);
• una scheda microSD: almeno 16 GB; prendete una scheda da 32 GB con il marchio A1 o A2, di una marca nota (SanDisk, Samsung, Kingston, o la scheda ufficiale Raspberry Pi). Compratela nel negozio della marca, da un rivenditore Raspberry Pi o in un negozio che la vende direttamente — non da un venditore sconosciuto di un marketplace: lì le schede false sono frequenti;
• l'alimentatore ufficiale: USB-C da 27 W per un Raspberry Pi 5, USB-C da 15 W per un Raspberry Pi 4 (un caricatore da telefono provoca spesso riavvii casuali);
• un case, con raffreddamento (ventola o dissipatore) per un Raspberry Pi 5;
• un cavo di rete abbastanza lungo da arrivare al vostro router.

Negozi, verificati l'11 ottobre 2026 (prezzi e disponibilità cambiano; Warda non ha alcun link di affiliazione e non guadagna nulla da questi negozi):

• Italia: Melopero, reichelt (dalla Germania), MediaWorld, Unieuro e Amazon.it (schede, vendute da Amazon stessa).
• Svizzera: Pi-Shop.ch, EducaWeb.ch, Galaxus, Digitec e Brack (schede).

Altri paesi, e cosa vende ogni negozio: Where to buy the hardware (in inglese).

Con un Raspberry Pi (consigliato)#

Vi serve un Raspberry Pi 4 (o successivo), il suo alimentatore, una scheda microSD da 16 GB o più e un cavo di rete.

Le schermate di questa sezione vengono da Raspberry Pi Imager 2.0.11 con l'interfaccia in francese, su Windows: le parole tra parentesi sono le sue etichette in francese. Quelle dei passaggi qui sotto mostrano Warda 0.7.8: Imager propone la versione attuale.

1. Installate Raspberry Pi Imager (2.0.2 o successivo) sul vostro computer. Sulla pagina delle release, scaricate il file warda.rpi-imager-manifest e apritelo (doppio clic): Imager si avvia con Warda nel suo elenco di sistemi. Primo passaggio (Appareil): scegliete il vostro Raspberry, Raspberry Pi 5 o Raspberry Pi 4 (il manifest dà a Imager questi due modelli, i soli in elenco), e proseguite con il pulsante in basso a destra (SUIVANT).

   

   

2. Secondo passaggio (OS): scegliete Warda <version>, in cima all'elenco. Imager scarica l'immagine da solo e ne verifica l'impronta. Con l'immagine .img.xz scelta tramite l'immagine personalizzata (Utiliser image personnalisée), Imager non propone la personalizzazione.

   

3. Terzo passaggio (Stockage): scegliete la vostra scheda microSD. Lasciate spuntata la casella che esclude i dischi di sistema (Exclure les disques système): i dischi del vostro computer non compaiono.

   

4. La personalizzazione (Personnalisation) comincia dal nome host (Nom d'hôte): date un nome al Raspberry sulla vostra rete, per esempio warda-lab (solo lettere, cifre e trattini).

   

5. Localizzazione (Localisation): scegliete la vostra capitale, il vostro fuso orario e la vostra tastiera (Ville capitale, Fuseau horaire, Type de clavier).

   

6. Utente (Utilisateur): create il vostro utente, con il suo nome utente (Nom d'utilisateur) e la sua password, da digitare due volte (Mot de passe, Confirmer le mot de passe).

   

7. Wi-Fi (Wi-Fi): lasciate tutto vuoto e proseguite (SUIVANT): Warda si collega con un cavo di rete.

   

8. Accesso remoto (Accès à distance): per poter essere aiutati da lontano, attivate SSH (Activer SSH), scegliete l'autenticazione con chiave pubblica (Utiliser l'authentification par clé publique) e incollate la vostra chiave pubblica. Warda rifiuta le password via SSH: con la sola password, SSH rifiuterà la connessione.

   

9. Imager mostra il riepilogo (Écriture): il modello di Raspberry, il sistema e la scheda, poi le personalizzazioni che applicherà (Personnalisation à appliquer). Controllateli, poi avviate la scrittura (ÉCRIRE).

   

   

10. Imager avverte che tutto ciò che è sulla scheda sta per essere cancellato, in modo definitivo. Controllate che nomini la vostra scheda, poi confermate (JE COMPRENDS, EFFACER ET ÉCRIRE).

    

11. Imager scrive l'immagine: non scollegate la scheda.

    

12. Poi verifica ciò che ha scritto: lasciatelo finire.

    

13. Quando tutto è finito (Écriture terminée !), Imager elenca le personalizzazioni applicate e ha espulso la scheda: toglietela e chiudete Imager (TERMINER). Inserite la scheda nel Raspberry, collegatelo al router con il cavo di rete, poi collegate l'alimentazione. Il primo avvio richiede alcuni minuti.

    

    

Con il file immagine, senza il manifest. L'altro modo di scrivere la scheda: scaricate l'immagine warda_<version>_raspberrypi-arm64.img.xz dalla pagina delle release e date voi stessi quel file a Imager. I due modi differiscono in una cosa: con il file immagine Imager non ha il passaggio della personalizzazione, mentre il manifest gli permette di impostare il nome host, l'utente, il Wi-Fi e SSH prima di scrivere. Le schermate mostrano un file più vecchio, già decompresso (warda_0.6.9_raspberrypi-arm64.img): prendete quello della release attuale.

1. Primo passaggio (Appareil): scegliete il vostro modello di Raspberry, Raspberry Pi 5 o Raspberry Pi 4, e proseguite con il pulsante in basso a destra (SUIVANT).

   

   

2. Secondo passaggio (OS): scendete fino in fondo all'elenco e scegliete la sua ultima voce, l'immagine personalizzata (Utiliser image personnalisée), poi il file di Warda che avete scaricato.

   

3. Terzo passaggio (Stockage): scegliete la vostra scheda microSD. Lasciate spuntata la casella che esclude i dischi di sistema (Exclure les disques système): i dischi del vostro computer non compaiono.

   

4. Il passaggio della personalizzazione (Personnalisation) resta in grigio: Imager lo salta e mostra il riepilogo (Écriture). Controllate il modello di Raspberry, il file e la scheda, poi avviate la scrittura (ÉCRIRE).

   

   

5. Imager avverte che tutto ciò che è sulla scheda sta per essere cancellato, in modo definitivo. Controllate che nomini la vostra scheda, poi confermate (JE COMPRENDS, EFFACER ET ÉCRIRE).

   

6. Imager scrive l'immagine: non scollegate la scheda.

   

7. Poi verifica ciò che ha scritto: lasciatelo finire.

   

8. Quando tutto è finito (Écriture terminée !), Imager ha espulso la scheda: toglietela e chiudete Imager (TERMINER).

   

   

Proseguite poi come nell'ultimo passaggio del primo modo: la scheda nel Raspberry, il cavo di rete, l'alimentazione.

Su una macchina Debian o Ubuntu#

Scaricate il pacchetto della vostra macchina (amd64 per un PC, arm64 per un Raspberry Pi già installato), poi:

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

Le porte 53, 80 e 443 devono essere libere: fermate prima un altro Pi-hole, dnsmasq o server web sulla stessa macchina.

Su Fedora, RHEL, Rocky Linux o AlmaLinux#

Scaricate il pacchetto rpm della vostra macchina (x86_64 per un PC, aarch64 per una macchina ARM), poi:

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

Il pacchetto apre le porte di Warda in firewalld (servizio warda), e Warda si aggiorna da solo, come con il pacchetto Debian. Le porte 53, 80 e 443 devono essere libere: su Fedora, systemd-resolved occupa spesso la porta 53; scrivete DNSStubListener=no in /etc/systemd/resolved.conf, poi eseguite sudo systemctl restart systemd-resolved.

Con Docker#

Su un Raspberry Pi 4 o successivo con un sistema a 64 bit, o su qualsiasi macchina a 64 bit (PC o ARM) con Docker e il suo plugin Compose. Ogni versione di Warda arriva con un docker-compose.yml pronto, che installa quella versione. In una cartella vuota:

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

Lo stesso file si trova anche nella radice del repository delle versioni: sempre quello dell'ultima versione.

Warda usa direttamente la rete della macchina: le porte 53 (DNS), 80 e 443 (interfaccia web) devono essere libere.

Un reverse proxy (Traefik, nginx, Caddy) o un NAS usa già le porte 80 e 443? Prima di docker compose up -d, cambiate queste due righe di docker-compose.yml (sotto environment:), poi aprite Warda all'indirizzo http://<indirizzo della macchina>:8080:

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

La porta 53 è occupata? Non si può spostare: i dispositivi chiedono solo quella porta. Fermate l'altro server DNS (Pi-hole, AdGuard Home, dnsmasq). Su Debian o Ubuntu spesso è systemd-resolved: scrivete DNSStubListener=no in /etc/systemd/resolved.conf, poi eseguite sudo systemctl restart systemd-resolved.

Poi:

docker logs warda
docker exec warda warda setup-info

Il primo comando mostra l'indirizzo da aprire (con la sua porta), il secondo la password predefinita. Se una porta è già in uso, Warda si ferma e il suo registro indica la porta, il programma che probabilmente la occupa e la riga del file da cambiare; Docker lo riavvia, circa una volta al minuto, finché la porta non è libera. Il registro del container resta piccolo (3 file da 10 MB).

Per aggiornare, scrivete il numero della nuova versione nella riga image: del file, poi:

docker compose pull && docker compose up -d

Scaricare di nuovo il file della nuova versione funziona anche, ma sostituisce le porte che avete cambiato. Spostare le porte 80 e 443 condivide solo la macchina con il vostro reverse proxy: non pubblicate mai Warda su Internet attraverso di esso (capitolo 12).

Primo accesso#

1. Da un computer della rete, aprite http://warda (o http://ADDRESS-OF-THE-BOX). Il certificato è autofirmato: accettatelo una volta.

2. Accedete entro un'ora dall'avvio con l'account admin e la password predefinita Ward@-MM-YYYY, dove MM-YYYY è il mese della versione (per esempio Ward@-09-2026). Oltre quel termine, scollegate il dispositivo Warda e ricollegatelo. Questa password è pubblica: finché il dispositivo non è installato, chiunque sulla vostra rete potrebbe installarlo al vostro posto. Installatelo subito dopo il suo primo avvio, da un computer della vostra rete (capitolo 12).

3. Si apre l'assistente di installazione, un passaggio alla volta: una nuova password per admin (l'account di emergenza: conservatela in un luogo sicuro), il vostro account personale, poi il vostro dispositivo (capitolo 3) e il vostro nucleo familiare (capitolo 4).

   Il primo passaggio presenta le condizioni d'uso, da leggere e accettare (un riassunto e il link al testo completo); vi è mostrato anche il conteggio anonimo giornaliero, attivo, che potete deselezionare.

Più avanti, quando il box ha il suo nome e un certificato riconosciuto dai browser (capitolo 3), http://warda porta da solo a https:// seguito da quel nome, e il browser non mostra più alcun avviso (da Warda 0.7.10).

State sostituendo un vecchio dispositivo Warda? Sulla prima schermata dell'assistente, Ho un backup di Warda riporta tutti i vostri account e le impostazioni (capitolo 6).

Al passo della rete, l'assistente mostra anche il paese del dispositivo e, quando il fuso orario del dispositivo non è quello del vostro browser, propone Usa Europe/Paris (il vostro fuso): gli orari di Internet e i report seguono l'ora del dispositivo. L'immagine per Raspberry Pi parte in UTC: si imposta qui.