Skip to main content

Prise en main

Installation​

Publications officielles​

Téléchargez l'archive contenant le fichier binaire pour votre système d'exploitation à partir de la [dernière page de version stable][versions]. La liste complète des plateformes prises en charge ainsi que les liens vers les versions bêta et edge (non-stables) sont disponibles sur [notre page plateformes][plateformes].

Pour installer AdGuard Home en tant que service, extrayez l'archive, entrez dans le répertoire AdGuardHome et exécutez :

./AdGuardHome -s install

Notes​

  • Utilisateurs de Fedora Linux et de ses dérivés : installez AdGuard Home dans le répertoire /usr/local/bin. Le non-respect de cela peut causer des problèmes avec SELinux et les autorisations. Voir [problème 765] et [problème 3281].

  • Les utilisateurs de macOS 10.15 Catalina et plus récents doivent placer le répertoire de travail d'AdGuard Home dans le répertoire /Applications.

Docker et Snap​

Nous fournissons également une image officielle docker AdGuard Home et un paquet officiel Snap Store pour les utilisateurs expérimentés.

Autres​

Certaines autres options non officielles incluent :

Premier démarrage​

Tout d'abord, vérifiez les paramètres de votre pare-feu. Pour installer et utiliser AdGuard Home, les ports et protocoles suivants doivent être disponibles :

  • 3000/TCP pour l'installation initiale;
  • 80/TCP pour l'interface web;
  • 53/UDP pour le serveur DNS.

Vous devrez peut-être ouvrir des ports supplémentaires pour des protocoles autres que le DNS simple, tels que DNS-over-HTTPS.

Les serveurs DNS se lient au port 53, ce qui nécessite des privilèges de super-utilisateur la plupart du temps, voir ci-dessous. Par conséquent, sur les systèmes Unix, vous devrez le lancer avec sudo ou doas dans le terminal :

sudo ./AdGuardHome

Sur Windows, exécutez cmd.exe ou PowerShell avec des privilèges d'administrateur et exécutez AdGuardHome.exe à partir de là.

Lorsque vous exécutez AdGuard Home pour la première fois, il commence à écouter sur 0.0.0.0:3000 et vous invite à l'ouvrir dans votre navigateur :

AdGuard Home est disponible aux adresses suivantes :
aller à http://127.0.0.1:3000
aller à http://[::1]:3000
[…]

Là, vous passerez par l'assistant de configuration initiale.

Écran de sélection de l'interface réseau AdGuard Home

Écran de création d'utilisateur AdGuard Home

Voir notre article sur l'exécution d'AdGuard Home en toute sécurité pour des conseils sur la manière de choisir la configuration initiale qui vous convient le mieux.

Fonctionnement en tant que service​

L'étape suivante consiste à enregistrer AdGuard Home en tant que service système (alias daemon). Pour installer AdGuard Home en tant que service, exécutez :

sudo ./AdGuardHome -s install

Sur Windows, exécutez cmd.exe avec des privilèges d'administrateur et exécutez AdGuardHome.exe -s install pour enregistrer un service Windows.

Voici les autres commandes dont vous pourriez avoir besoin pour contrôler le service :

  • AdGuardHome -s uninstall : Désinstaller le service AdGuard Home.
  • AdGuardHome -s start : Démarrer le service.
  • AdGuardHome -s stop : Arrêter le service.
  • AdGuardHome -s restart : Redémarrer le service.
  • AdGuardHome -s status : Afficher l'état actuel du service.

Les journaux​

Par défaut, les journaux sont écrits dans stderr lorsque vous exécutez AdGuard Home dans un terminal. Si vous l'exécutez en tant que service, la sortie des journaux dépend de la plateforme :

  • Sur macOS, le journal est écrit dans des fichiers /var/log/AdGuardHome.*.log.

  • Sur d'autres systèmes Unix, le journal est écrit dans syslog ou journald.

  • Sur Windows, le journal est écrit dans le journal d'événements Windows.

Vous pouvez modifier ce comportement dans le fichier de configuration AdGuard Home.

Mise à jour​

Un exemple de notification de mise à jour

Lorsqu'une nouvelle version est publiée, l'interface utilisateur d'AdGuard Home affiche un message de notification et le bouton Mettre à jour maintenant. Cliquez sur ce bouton, et AdGuard Home sera automatiquement mis à jour vers la version la plus récente. Votre fichier exécutable AdGuard Home actuel est enregistré dans le répertoire backup avec le fichier de configuration actuel, afin que vous puissiez revenir en arrière en cas de besoin.

Mise à jour manuelle​

In case the button isn’t shown or an automatic update has failed, you can update manually. We have a detailed guide on manual updates, but in short:

  1. Download the new AdGuard Home package.

  2. Extract it to a temporary directory.

  3. Replace the old AdGuard Home executable file with the new one.

  4. Restart AdGuard Home.

Docker, Home Assistant, and Snapcraft updates​

Auto-updates for Docker, Hass.io/Home Assistant, and Snapcraft installations are disabled. Update the image instead.

Command-line update​

To update AdGuard Home package without the need to use Web API run:

./AdGuardHome --update

Configurer les appareils​

Router​

This setup will automatically cover all devices connected to your home router, and you won’t need to configure each of them manually.

  1. Ouvrez les préférences de votre routeur. Usually, you can access it from your browser via a URL, such as http://192.168.0.1/ or http://192.168.1.1/. You may be prompted to enter a password. If you don’t remember it, you can often reset the password by pressing a button on the router itself, but be aware that if this procedure is chosen, you will probably lose the entire router configuration. If your router requires an app to set it up, please install the app on your phone or PC and use it to access the router’s settings.

  2. Find the DHCP/DNS settings. Look for the DNS letters next to a field that allows two or three sets of numbers, each divided into four groups of one to three digits.

  3. Enter your AdGuard Home server addresses there.

  4. On some router types, a custom DNS server cannot be set up. In that case, setting up AdGuard Home as a DHCP server may help. Otherwise, you should consult your router manual to learn how to customize DNS servers on your specific router model.

Windows​

  1. Open Control Panel from the Start menu or Windows search.

  2. Go to Network and Internet and then to Network and Sharing Center.

  3. On the left side of the screen, find the Change adapter settings button and click it.

  4. Select your active connection, right-click it and choose Properties.

  5. Find Internet Protocol Version 4 (TCP/IPv4) (or, for IPv6, Internet Protocol Version 6 (TCP/IPv6)) in the list, select it, and then click Properties again.

  6. Choose Use the following DNS server addresses and enter your AdGuard Home server addresses.

macOS​

  1. Click the Apple icon and go to System Preferences.

  2. Cliquez sur Réseau.

  3. Select the first connection in your list and click Advanced.

  4. Select the DNS tab and enter your AdGuard Home server addresses.

Android​

note

Instructions for Android devices may differ depending on the OS version and the manufacturer.

  1. From the Android menu home screen, tap Settings.

  2. Tap Wi-Fi on the menu. The screen with all of the available networks will be displayed (it is impossible to set custom DNS for mobile connection).

  3. Long press the network you’re connected to and tap Modify Network.

  4. On some devices, you may need to check the box for Advanced to see more settings. To adjust your Android DNS settings, you will need to change the IP settings from DHCP to Static.

  5. Change set DNS 1 and DNS 2 values to your AdGuard Home server addresses.

iOS​

  1. From the home screen, tap Settings.

  2. Select Wi-Fi from the left menu (it is impossible to configure DNS for mobile networks).

  3. Tap the name of the currently active network.

  4. In the DNS field, enter your AdGuard Home server addresses.

Running without superuser​

You can run AdGuard Home without superuser privileges, but you must either grant the binary a capability (on Linux) or instruct it to use a different port (all platforms).

Granting the necessary capabilities (Linux only)​

Using this method requires the setcap utility. You may need to install it using your Linux distribution’s package manager.

To allow AdGuard Home running on Linux to listen on port 53 without superuser privileges and bind its DNS servers to a particular interface, run:

sudo setcap 'CAP_NET_BIND_SERVICE=+eip CAP_NET_RAW=+eip' ./AdGuardHome

Then run ./AdGuardHome as an unprivileged user.

Changing the DNS listen port​

To configure AdGuard Home to listen on a port that does not require superuser privileges, stop AdGuard Home, open AdGuardHome.yaml in your editor, and find these lines:

dns:
    # …
    port: 53

You can change the port to anything above 1024 to avoid requiring superuser privileges.

Limitations​

Some file systems don’t support the mmap(2) system call required by the statistics system. See also issue 1188.

You can resolve this issue:

  • either by supplying the --work-dir DIRECTORY arguments to the AdGuardHome binary. This option will tell AGH to use another directory for all its files instead of the default ./data directory.

  • or by creating symbolic links pointing to another file system that supports mmap(2) (e.g. tmpfs):

    ln -s ${YOUR_AGH_PATH}/data/stats.db /tmp/stats.db
    ln -s ${YOUR_AGH_PATH}/data/sessions.db /tmp/sessions.db