2. Instalar o Warda

Onde comprar o hardware#

O que comprar:

• um Raspberry Pi 5 ou um Raspberry Pi 4 (os dois modelos que o Warda suporta);
• um cartão microSD: pelo menos 16 GB; escolha um cartão de 32 GB marcado A1 ou A2, de uma marca conhecida (SanDisk, Samsung, Kingston, ou o cartão oficial Raspberry Pi). Compre-o na loja da marca, num revendedor Raspberry Pi ou numa loja que o venda ela própria — não a um vendedor desconhecido de um marketplace: os cartões falsos são frequentes aí;
• a fonte de alimentação oficial: USB-C de 27 W para um Raspberry Pi 5, USB-C de 15 W para um Raspberry Pi 4 (um carregador de telemóvel provoca muitas vezes reinícios ao acaso);
• uma caixa, com arrefecimento (ventoinha ou dissipador) para um Raspberry Pi 5;
• um cabo de rede comprido o suficiente para chegar ao seu router.

Lojas em Portugal, verificadas a 11 de outubro de 2026 (os preços e o stock mudam; o Warda não tem nenhuma ligação de afiliado e não ganha nada com estas lojas): Robert Mauser, PTRobotics, Farnell Portugal, Worten e Amazon.es (cartões, vendidos pela própria Amazon).

Outros países, e o que vende cada loja: Where to buy the hardware (em inglês).

Com um Raspberry Pi (recomendado)#

Precisa de um Raspberry Pi 4 (ou posterior), a respetiva fonte de alimentação, um cartão microSD de 16 GB ou mais e um cabo de rede.

As capturas desta secção vêm do Raspberry Pi Imager 2.0.11 com a interface em francês, no Windows: as palavras entre parênteses são as suas etiquetas em francês. As dos passos seguintes mostram o Warda 0.7.8: o Imager propõe a versão atual.

1. Instale o Raspberry Pi Imager (2.0.2 ou posterior) no seu computador. Na página de lançamentos, transfira o ficheiro warda.rpi-imager-manifest e abra-o (duplo clique): o Imager arranca com o Warda na sua lista de sistemas. Primeiro passo (Appareil): escolha o seu Raspberry, Raspberry Pi 5 ou Raspberry Pi 4 (o manifesto dá ao Imager estes dois modelos, os únicos da lista), e avance com o botão em baixo à direita (SUIVANT).

   

   

2. Segundo passo (OS): escolha Warda <version>, no topo da lista. O Imager transfere a imagem sozinho e verifica a sua impressão digital. Com a imagem .img.xz escolhida através da imagem personalizada (Utiliser image personnalisée), o Imager não propõe a personalização.

   

3. Terceiro passo (Stockage): escolha o seu cartão microSD. Deixe assinalada a caixa que exclui os discos do sistema (Exclure les disques système): os discos do seu computador não aparecem.

   

4. A personalização (Personnalisation) começa pelo nome da máquina (Nom d'hôte): dê um nome ao Raspberry na sua rede, por exemplo warda-lab (só letras, algarismos e hífenes).

   

5. Localização (Localisation): escolha a sua capital, o seu fuso horário e o seu teclado (Ville capitale, Fuseau horaire, Type de clavier).

   

6. Utilizador (Utilisateur): crie o seu utilizador, com o seu nome de utilizador (Nom d'utilisateur) e a sua palavra-passe, escrita duas vezes (Mot de passe, Confirmer le mot de passe).

   

7. Wi-Fi (Wi-Fi): deixe tudo vazio e avance (SUIVANT): o Warda liga-se com um cabo de rede.

   

8. Acesso remoto (Accès à distance): para poder ser ajudado à distância, ative o SSH (Activer SSH), escolha a autenticação por chave pública (Utiliser l'authentification par clé publique) e cole a sua chave pública. O Warda recusa palavras-passe por SSH: só com uma palavra-passe, o SSH recusará a ligação.

   

9. O Imager mostra o resumo (Écriture): o modelo de Raspberry, o sistema e o cartão, e depois as personalizações que vai aplicar (Personnalisation à appliquer). Verifique-os e inicie a escrita (ÉCRIRE).

   

   

10. O Imager avisa que tudo o que está no cartão vai ser apagado, de forma definitiva. Verifique que indica o seu cartão e confirme (JE COMPRENDS, EFFACER ET ÉCRIRE).

    

11. O Imager escreve a imagem: não desligue o cartão.

    

12. Depois verifica o que escreveu: deixe-o terminar.

    

13. Quando tudo estiver concluído (Écriture terminée !), o Imager enumera as personalizações aplicadas e ejetou o cartão: retire-o e feche o Imager (TERMINER). Coloque o cartão no Raspberry, ligue-o ao seu router com o cabo de rede e, depois, ligue a alimentação. O primeiro arranque demora alguns minutos.

    

    

Com o ficheiro de imagem, sem o manifesto. A outra forma de escrever o cartão: transfira a imagem warda_<version>_raspberrypi-arm64.img.xz na página de lançamentos e dê esse ficheiro ao Imager. As duas formas diferem numa coisa: com o ficheiro de imagem, o Imager não tem o passo da personalização, ao passo que o manifesto lhe permite definir o nome da máquina, o utilizador, o Wi-Fi e o SSH antes de escrever. As capturas mostram um ficheiro mais antigo, já descomprimido (warda_0.6.9_raspberrypi-arm64.img): use o do lançamento atual.

1. Primeiro passo (Appareil): escolha o seu modelo de Raspberry, Raspberry Pi 5 ou Raspberry Pi 4, e avance com o botão em baixo à direita (SUIVANT).

   

   

2. Segundo passo (OS): desça até ao fim da lista e escolha a sua última entrada, a imagem personalizada (Utiliser image personnalisée), e depois o ficheiro do Warda que transferiu.

   

3. Terceiro passo (Stockage): escolha o seu cartão microSD. Deixe assinalada a caixa que exclui os discos do sistema (Exclure les disques système): os discos do seu computador não aparecem.

   

4. O passo da personalização (Personnalisation) fica a cinzento: o Imager salta-o e mostra o resumo (Écriture). Verifique o modelo de Raspberry, o ficheiro e o cartão, e inicie a escrita (ÉCRIRE).

   

   

5. O Imager avisa que tudo o que está no cartão vai ser apagado, de forma definitiva. Verifique que indica o seu cartão e confirme (JE COMPRENDS, EFFACER ET ÉCRIRE).

   

6. O Imager escreve a imagem: não desligue o cartão.

   

7. Depois verifica o que escreveu: deixe-o terminar.

   

8. Quando tudo estiver concluído (Écriture terminée !), o Imager ejetou o cartão: retire-o e feche o Imager (TERMINER).

   

   

Continue depois como no último passo da primeira forma: o cartão no Raspberry, o cabo de rede, a alimentação.

Numa máquina Debian ou Ubuntu#

Transfira o pacote da sua máquina (amd64 para um PC, arm64 para um Raspberry Pi já instalado), depois:

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

As portas 53, 80 e 443 têm de estar livres: primeiro pare outro Pi-hole, dnsmasq ou servidor web na mesma máquina.

Em Fedora, RHEL, Rocky Linux ou AlmaLinux#

Transfira o pacote rpm da sua máquina (x86_64 para um PC, aarch64 para uma máquina ARM), depois:

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

O pacote abre as portas do Warda no firewalld (serviço warda), e o Warda atualiza-se sozinho, como com o pacote Debian. As portas 53, 80 e 443 têm de estar livres: no Fedora, o systemd-resolved ocupa muitas vezes a porta 53; escreva DNSStubListener=no em /etc/systemd/resolved.conf e depois execute sudo systemctl restart systemd-resolved.

Com o Docker#

Num Raspberry Pi 4 ou posterior com um sistema de 64 bits, ou em qualquer máquina de 64 bits (PC ou ARM) com o Docker e o seu plugin Compose. Cada versão do Warda traz um docker-compose.yml pronto a usar, que instala essa versão. Numa pasta vazia:

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

O mesmo ficheiro está também na raiz do repositório das versões: sempre o da versão mais recente.

O Warda usa diretamente a rede da máquina: as portas 53 (DNS), 80 e 443 (interface web) têm de estar livres.

Um proxy inverso (Traefik, nginx, Caddy) ou um NAS já usa as portas 80 e 443? Antes de docker compose up -d, mude estas duas linhas do docker-compose.yml (em environment:) e depois abra o Warda em http://<endereço da máquina>:8080:

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

A porta 53 está ocupada? Não pode mudar: os dispositivos só perguntam a essa porta. Pare o outro servidor DNS (Pi-hole, AdGuard Home, dnsmasq). No Debian ou no Ubuntu é muitas vezes o systemd-resolved: escreva DNSStubListener=no em /etc/systemd/resolved.conf e depois execute sudo systemctl restart systemd-resolved.

Depois:

docker logs warda
docker exec warda warda setup-info

O primeiro comando mostra o endereço a abrir (com a sua porta), o segundo a palavra-passe predefinida. Se uma porta já estiver em uso, o Warda pára e o seu registo indica a porta, o programa que provavelmente a ocupa e a linha do ficheiro a mudar; o Docker volta a arrancá-lo, cerca de uma vez por minuto, até a porta ficar livre. O registo do contentor fica pequeno (3 ficheiros de 10 MB).

Para atualizar, escreva o número da nova versão na linha image: do ficheiro, e depois:

docker compose pull && docker compose up -d

Transferir de novo o ficheiro da nova versão também funciona, mas substitui as portas que mudou. Mudar as portas 80 e 443 apenas partilha a máquina com o seu proxy inverso: nunca publique o Warda na Internet através dele (capítulo 12).

Primeiro início de sessão#

1. A partir de um computador da rede, abra http://warda (ou http://ADDRESS-OF-THE-BOX). O certificado é autoassinado: aceite-o uma vez.

2. Inicie sessão dentro da hora seguinte ao arranque com a conta admin e a palavra-passe predefinida Ward@-MM-YYYY, em que MM-YYYY é o mês da versão (por exemplo, Ward@-09-2026). Depois desse prazo, desligue a caixa da corrente e volte a ligá-la. Esta palavra-passe é pública: enquanto a caixa não estiver instalada, qualquer pessoa na sua rede poderia instalá-la no seu lugar. Instale-a logo após o primeiro arranque, a partir de um computador da sua própria rede (capítulo 12).

3. O assistente de instalação abre-se, passo a passo: uma nova palavra-passe para admin (a conta de emergência: guarde-a num local seguro), a sua própria conta, depois a sua caixa (capítulo 3) e o seu agregado familiar (capítulo 4).

   O primeiro passo apresenta as condições de utilização, a ler e aceitar (um resumo e a ligação para o texto completo); a contagem anónima diária também aí é mostrada, ativada, e pode desmarcá-la.

Mais tarde, quando a caixa tem o seu nome e um certificado reconhecido pelos navegadores (capítulo 3), http://warda leva por si só a https:// seguido desse nome, e o navegador deixa de mostrar qualquer aviso (a partir do Warda 0.7.10).

A substituir uma caixa antiga? No primeiro ecrã do assistente, Tenho uma cópia de segurança do Warda repõe todas as suas contas e definições (capítulo 6).

No passo da rede, o assistente mostra também o país da caixa e, quando o fuso horário da caixa não é o do seu navegador, propõe Usar Europe/Paris (o seu fuso): os horários de Internet e os relatórios seguem a hora da caixa. A imagem para Raspberry Pi arranca em UTC: é aqui que se acerta.