Ansible Role: AdguardHome

Description

This role helps you install and manage the AdGuardHome service using Ansible.

For complete configuration details, check out AdGuardHome Config.

Reset Web Password

AdGuard Home uses a BCrypt-encoded password.

The default password is "admin".

To change the password:

1. Stop AdGuard Home
2. Edit the AdGuardHome.yaml file
3. Locate the password field
4. Replace it with your new password. You can use the htpasswd tool or any online BCrypt generator.
5. Start AdGuard Home
6. You can now log into the web interface with your new password.

Example command with htpasswd:

htpasswd -bnBC 10 "" MY_NEW_PASS | tr -d ':'

Configuration in WebUI

:bangbang:	After finishing your setup in the WebUI, remember to save your configuration in the host variables.

Requirements

• Ansible version 2.9 or newer (may work on older versions, but not guaranteed)

Role Variables

All variables that you can change are listed in the defaults/main.yml file and in the table below.

Name	Default Value	Description
proxy_env	{}	Proxy environment variables for the client
adguard_version	0.107.0	The version of AdGuardHome; accepts latest as well.
adguard_web_listen_address	0.0.0.0	Address for AdGuardHome to listen on
adguard_web_listen_port	3200	Port for AdGuardHome to listen on
adguard_config_dir	/etc/adguard	Directory path for AdGuardHome configuration
adguard_db_dir	/var/lib/adguard	Directory path for AdGuardHome database
adguard_binary_install_dir	/usr/local/bin	Directory for binary installations
adguard_system_user	"{{ prometheus_user	default('adguard') }}"
adguard_system_group	"{{ prometheus_group	default('adguard') }}"
adguard_limit_nofile	8192	NoFile limit
#adguard_http_proxy	http://proxy:3128	Set system proxy as environment
#adguard_https_proxy	http://proxy:3128	Set system proxy as environment
adguard_config	{}	Configuration for AdGuardHome

Example Configuration

---
adguard_config:
  bind_host: "{{ adguard_web_listen_address }}"
  bind_port: "{{ adguard_web_listen_port }}"
  beta_bind_port: 0
  users:
  - name: admin
    password: $2y$12$SMsrAS0r0FPvpBPDPJygD.GO7V7jeUd2GI2KN.l.rubeV6aKVauEy
  auth_attempts: 5
  ...
  # (rest of the configuration follows)

Playbook Example

- hosts: all
  roles:
    - onkeldom.adguard_home

Contributing

See the contributor guideline.

License

This project is licensed under the MIT License. See LICENSE for more details.