Warda-DNSDocs

2. Instalar Warda

En resumen

Raspberry Pi 4 o posterior: archivo warda.rpi-imager-manifest abierto en Raspberry Pi Imager 2.x (ofrece la imagen de Warda con la personalización; SSH solo por clave). Debian/Ubuntu de 64 bits: sudo apt install ./warda_<version>_<arch>.deb. Docker: imagen warda-dns/warda, red del host, --restart unless-stopped. Puertos 53, 80 y 443 libres. Después http://<address> durante la hora siguiente, cuenta admin, contraseña Ward@-MM-YYYY (mes de la versión).

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.

  1. Instale Raspberry Pi Imager (2.0.2 o posterior) en su ordenador.
  2. 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. Elija su Raspberry, Warda <version>, y después su tarjeta. Imager descarga la imagen por sí solo y comprueba su huella. Con la imagen .img.xz elegida mediante "Use custom", Imager no ofrece la personalización.
  3. En los ajustes de Imager, cree su usuario. Para poder ayudar a distancia, active SSH con "Allow public-key authentication only" y su clave pública: Warda rechaza las contraseñas por SSH.
  4. 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.

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:

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

Con Docker#

sh
docker run -d --name warda --restart unless-stopped --network host \
  --user 0:0 --cap-drop ALL --cap-add NET_BIND_SERVICE \
  --cap-add NET_RAW --cap-add DAC_OVERRIDE --cap-add FOWNER \
  -e TZ=Europe/Paris -v warda-data:/var/lib/warda \
  <registry>/warda-dns/warda:latest

El archivo packaging/docker-compose.yml del proyecto ofrece un ejemplo completo y reforzado.

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.

  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.

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