Warda-DNS Warda: from ward — to protect, guardian
v0.9.10

Install Warda on a Raspberry Pi

The recommended way: a Raspberry Pi 5 or 4, a microSD card of 32 GB marked A1 or A2, the official power supply and a network cable to the router.

01Write the card

  1. 1Install Raspberry Pi Imager (2.0.2 or later), download the file warda.rpi-imager-manifest from the page of the releases and open it: Imager starts with Warda in its list.
  2. 2Choose your Raspberry (5 or 4), then Warda at the top of the systems, then your microSD card.
  3. 3In the customisation, give a hostname, your time zone, your user and its password; leave the Wi-Fi empty (Warda uses the cable); for SSH, choose the public key: Warda refuses passwords over SSH.
  4. 4Check the summary, confirm that the card may be erased, and let Imager write then verify it.

02Or with the image file

You can also download warda_<version>_raspberrypi-arm64.img.xz and give it to Imager as a custom image: Imager then skips the customisation. Check the file against SHA256SUMS, from the same release, before writing it.

bash
sha256sum -c SHA256SUMS --ignore-missing

03First start and first sign-in

The default password is public: install the box right after its first start, from your own network. The Raspberry Pi image starts on UTC: choose your time zone in the assistant.

  1. 1Put the card in the Raspberry, plug it into the router with the cable, then plug the power in: the first start takes a few minutes.
  2. 2From a computer of your network, open http://warda (or the address of the box) and accept the self-signed certificate once.
  3. 3Within the hour after the start, sign in with admin and the password Ward@-MM-YYYY (the month of the version, for example Ward@-09-2026). Past the hour, unplug the box and plug it back.
  4. 4The assistant asks you to accept the terms of use, to choose a new password for admin and your own account, then sets up the network and the household.

Point the router DNS to Warda

See also

Still stuck?

Tell us what happened, with the version of Warda: the form of the beta page reaches the team, or write to [email protected]. A diagnostic of System (Download a diagnostic, without any site visited) helps a lot.

Report a problemWrite to us