2. Instalar Warda

Dónde comprar el hardware#

Lo que hay que comprar:

• una Raspberry Pi 5 o una Raspberry Pi 4 (los dos modelos que Warda admite);
• una tarjeta microSD: 16 GB como mínimo; elija una tarjeta de 32 GB marcada A1 o A2, de una marca conocida (SanDisk, Samsung, Kingston, o la tarjeta oficial de Raspberry Pi). Cómprela en la tienda de la marca, en un distribuidor de Raspberry Pi o en una tienda que la venda ella misma — no a un vendedor desconocido de un marketplace: las tarjetas falsas son frecuentes allí;
• la fuente de alimentación oficial: USB-C de 27 W para una Raspberry Pi 5, USB-C de 15 W para una Raspberry Pi 4 (un cargador de teléfono provoca a menudo reinicios al azar);
• una caja, con refrigeración (ventilador o disipador) para una Raspberry Pi 5;
• un cable de red lo bastante largo para llegar a su router.

Tiendas en España, comprobadas el 11 de octubre de 2026 (los precios y las existencias cambian; Warda no tiene ningún enlace de afiliado y no gana nada con estas tiendas): Tiendatec, Raspipc, PcComponentes, RS España y MediaMarkt España (tarjetas).

Otros países, y lo que vende cada tienda: Where to buy the hardware (en inglés).

Con una Raspberry Pi (recomendado)#

Necesita una Raspberry Pi 4 (o posterior), su fuente de alimentación, una tarjeta microSD de 16 GB o más y un cable de red.

Las capturas de esta sección vienen de Raspberry Pi Imager 2.0.11 con la interfaz en francés, en Windows: las palabras entre paréntesis son sus etiquetas en francés. Las de los pasos siguientes muestran Warda 0.7.8: Imager ofrece la versión actual.

1. Instale Raspberry Pi Imager (2.0.2 o posterior) en su ordenador. En la página de versiones, descargue el archivo warda.rpi-imager-manifest y ábralo (doble clic): Imager arranca con Warda en su lista de sistemas. Primer paso (Appareil): elija su Raspberry, Raspberry Pi 5 o Raspberry Pi 4 (el manifiesto da a Imager estos dos modelos, los únicos de la lista), y continúe con el botón de abajo a la derecha (SUIVANT).

   

   

2. Segundo paso (OS): elija Warda <version>, al principio de la lista. Imager descarga la imagen por sí solo y comprueba su huella. Con la imagen .img.xz elegida mediante la imagen personalizada (Utiliser image personnalisée), Imager no ofrece la personalización.

   

3. Tercer paso (Stockage): elija su tarjeta microSD. Deje marcada la casilla que excluye los discos del sistema (Exclure les disques système): los discos de su ordenador no aparecen.

   

4. La personalización (Personnalisation) empieza por el nombre del equipo (Nom d'hôte): dé un nombre a la Raspberry en su red, por ejemplo warda-lab (solo letras, cifras y guiones).

   

5. Localización (Localisation): elija su capital, su zona horaria y su teclado (Ville capitale, Fuseau horaire, Type de clavier).

   

6. Usuario (Utilisateur): cree su usuario, con su nombre de usuario (Nom d'utilisateur) y su contraseña, que se escribe dos veces (Mot de passe, Confirmer le mot de passe).

   

7. Wi-Fi (Wi-Fi): déjelo todo vacío y continúe (SUIVANT): Warda se conecta con un cable de red.

   

8. Acceso remoto (Accès à distance): para poder ayudar a distancia, active SSH (Activer SSH), elija la autenticación por clave pública (Utiliser l'authentification par clé publique) y pegue su clave pública. Warda rechaza las contraseñas por SSH: con una contraseña sola, SSH rechazará la conexión.

   

9. Imager muestra el resumen (Écriture): el modelo de Raspberry, el sistema y la tarjeta, y después las personalizaciones que va a aplicar (Personnalisation à appliquer). Compruébelos y lance la escritura (ÉCRIRE).

   

   

10. Imager avisa de que todo lo que hay en la tarjeta se va a borrar, de forma definitiva. Compruebe que nombra su tarjeta y confirme (JE COMPRENDS, EFFACER ET ÉCRIRE).

    

11. Imager escribe la imagen: no desconecte la tarjeta.

    

12. Después comprueba lo que ha escrito: déjelo terminar.

    

13. Cuando todo ha terminado (Écriture terminée !), Imager enumera las personalizaciones aplicadas y ha expulsado la tarjeta: retírela y cierre Imager (TERMINER). Ponga la tarjeta en la Raspberry, conéctela a su router con el cable de red y después enchufe la alimentación. El primer arranque tarda unos minutos.

    

    

Con el archivo de imagen, sin el manifiesto. La otra forma de escribir la tarjeta: descargue la imagen warda_<version>_raspberrypi-arm64.img.xz en la página de versiones y dé usted mismo ese archivo a Imager. Las dos formas se diferencian en una cosa: con el archivo de imagen, Imager no tiene paso de personalización, mientras que el manifiesto le permite ajustar el nombre del equipo, el usuario, el Wi-Fi y SSH antes de escribir. Las capturas muestran un archivo más antiguo, ya descomprimido (warda_0.6.9_raspberrypi-arm64.img): tome el de la versión actual.

1. Primer paso (Appareil): elija su modelo de Raspberry, Raspberry Pi 5 o Raspberry Pi 4, y continúe con el botón de abajo a la derecha (SUIVANT).

   

   

2. Segundo paso (OS): baje hasta el final de la lista y elija su última entrada, la imagen personalizada (Utiliser image personnalisée), y después el archivo de Warda que ha descargado.

   

3. Tercer paso (Stockage): elija su tarjeta microSD. Deje marcada la casilla que excluye los discos del sistema (Exclure les disques système): los discos de su ordenador no aparecen.

   

4. El paso de la personalización (Personnalisation) queda en gris: Imager lo salta y muestra el resumen (Écriture). Compruebe el modelo de Raspberry, el archivo y la tarjeta, y lance la escritura (ÉCRIRE).

   

   

5. Imager avisa de que todo lo que hay en la tarjeta se va a borrar, de forma definitiva. Compruebe que nombra su tarjeta y confirme (JE COMPRENDS, EFFACER ET ÉCRIRE).

   

6. Imager escribe la imagen: no desconecte la tarjeta.

   

7. Después comprueba lo que ha escrito: déjelo terminar.

   

8. Cuando todo ha terminado (Écriture terminée !), Imager ha expulsado la tarjeta: retírela y cierre Imager (TERMINER).

   

   

Continúe después como en el último paso de la primera forma: la tarjeta en la Raspberry, el cable de red, la alimentación.

En un equipo Debian o Ubuntu#

Descargue el paquete de su equipo (amd64 para un PC, arm64 para una Raspberry Pi ya instalada) y después:

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

Los puertos 53, 80 y 443 deben estar libres: detenga antes cualquier otro Pi-hole, dnsmasq o servidor web en el mismo equipo.

En Fedora, RHEL, Rocky Linux o AlmaLinux#

Descargue el paquete rpm de su equipo (x86_64 para un PC, aarch64 para un equipo ARM) y después:

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

El paquete abre los puertos de Warda en firewalld (servicio warda), y Warda se actualiza solo, como con el paquete Debian. Los puertos 53, 80 y 443 deben estar libres: en Fedora, systemd-resolved suele ocupar el puerto 53; escriba DNSStubListener=no en /etc/systemd/resolved.conf y después ejecute sudo systemctl restart systemd-resolved.

Con Docker#

En una Raspberry Pi 4 o posterior con un sistema de 64 bits, o en cualquier máquina de 64 bits (PC o ARM) con Docker y su complemento Compose. Cada versión de Warda trae un docker-compose.yml listo para usar, que instala esa versión. En una carpeta vacía:

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

El mismo archivo está también en la raíz del repositorio de las versiones: siempre el de la última versión.

Warda usa directamente la red de la máquina: los puertos 53 (DNS), 80 y 443 (interfaz web) deben estar libres.

¿Un proxy inverso (Traefik, nginx, Caddy) o un NAS ya usa los puertos 80 y 443? Antes de docker compose up -d, cambie estas dos líneas de docker-compose.yml (bajo environment:) y abra después Warda en http://<dirección de la máquina>:8080:

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

¿El puerto 53 está ocupado? No puede cambiar: los dispositivos solo preguntan a ese puerto. Detenga el otro servidor DNS (Pi-hole, AdGuard Home, dnsmasq). En Debian o Ubuntu suele ser systemd-resolved: escriba DNSStubListener=no en /etc/systemd/resolved.conf y ejecute después sudo systemctl restart systemd-resolved.

Después:

docker logs warda
docker exec warda warda setup-info

La primera orden muestra la dirección que hay que abrir (con su puerto), la segunda la contraseña predeterminada. Si un puerto ya está en uso, Warda se detiene y su registro indica el puerto, el programa que probablemente lo ocupa y la línea del archivo que hay que cambiar; Docker lo vuelve a arrancar, más o menos una vez por minuto, hasta que el puerto quede libre. El registro del contenedor se mantiene pequeño (3 archivos de 10 MB).

Para actualizar, escriba el número de la nueva versión en la línea image: del archivo, y después:

docker compose pull && docker compose up -d

Descargar de nuevo el archivo de la nueva versión también funciona, pero sustituye los puertos que usted cambió. Mover los puertos 80 y 443 solo comparte la máquina con su proxy inverso: nunca publique Warda en Internet a través de él (capítulo 12).

Primer inicio de sesión#

1. Desde un ordenador de la red, abra http://warda (o http://ADDRESS-OF-THE-BOX). El certificado es autofirmado: acéptelo una vez.

2. Inicie sesión durante la hora siguiente al arranque con la cuenta admin y la contraseña predeterminada Ward@-MM-YYYY, donde MM-YYYY es el mes de la versión (por ejemplo Ward@-09-2026). Pasado ese tiempo, desenchufe el equipo y vuelva a enchufarlo. Esta contraseña es pública: mientras el equipo no esté instalado, cualquiera en su red podría instalarlo en su lugar. Instálelo justo después de su primer arranque, desde un ordenador de su propia red (capítulo 12).

3. Se abre el asistente de instalación, paso a paso: una contraseña nueva para admin (la cuenta de emergencia: guárdela en un lugar seguro), su propia cuenta, y después su equipo (capítulo 3) y su hogar (capítulo 4).

   El primer paso presenta las condiciones de uso, que debe leer y aceptar (un resumen y el enlace al texto completo); ahí se muestra también el recuento anónimo diario, activado, y puede desmarcarlo.

Más adelante, cuando el equipo tiene su nombre y un certificado que los navegadores reconocen (capítulo 3), http://warda lleva por sí solo a https:// seguido de ese nombre, y el navegador ya no muestra ninguna advertencia (desde Warda 0.7.10).

¿Está sustituyendo un equipo antiguo? En la primera pantalla del asistente, Tengo una copia de seguridad de Warda recupera todas sus cuentas y ajustes (capítulo 6).

En el paso de la red, el asistente muestra también el país del equipo y, cuando la zona horaria del equipo no es la de su navegador, propone Usar Europe/Paris (su zona): los horarios de Internet y los informes siguen la hora del equipo. La imagen de Raspberry Pi arranca en UTC: se ajusta aquí.