From 34d124e1c7700b4da1c838f96c45045f7d89b19d Mon Sep 17 00:00:00 2001 From: Ainar Garipov Date: Wed, 5 Oct 2022 18:51:27 +0300 Subject: [PATCH] Pull request: 5000-5001-passwd-fedora Updates AdguardTeam/AdGuardHome#5000. Updates AdguardTeam/AdGuardHome#5001. Squashed commit of the following: commit ef7dd9c3d5864f15b3ff1558b6aecbb2ea6e1651 Author: Ainar Garipov Date: Wed Oct 5 18:36:22 2022 +0300 all: imp passwd reset, clients; mention leases.db --- Clients.md | 4 ++-- Configuration.md | 56 ++++++++++++++++++++++++++++++++---------------- FAQ.md | 4 ++++ 3 files changed, 43 insertions(+), 21 deletions(-) diff --git a/Clients.md b/Clients.md index 2ada723..d3fa718 100644 --- a/Clients.md +++ b/Clients.md @@ -39,7 +39,7 @@ you may need to restart AdGuard Home to apply the changes. ![](images/top-clients-names.png) -Since **v0.108.0** runtime clients sources can be disabled via the +Since **v0.107.7** runtime clients sources can be disabled via the [`clients.runtime_sources`][sources] object of the configuration file. [whois]: https://en.wikipedia.org/wiki/WHOIS @@ -89,7 +89,7 @@ clients should perform queries using a special domain name or URL. For example: * **DNS-over-HTTPS:** `https://example.org/dns-query/my-client`. - **Since **v0.108.0-b.18:** `https://my-client.example.org/dns-query` + Since **v0.108.0-b.18:** `https://my-client.example.org/dns-query` (requires a [wildcard certificate][wild]). **NOTE:** The URL ClientID has higher priority than the server-name ClientID. If you use both, only the URL ClientID is used. diff --git a/Configuration.md b/Configuration.md index 74ded77..ef5e678 100644 --- a/Configuration.md +++ b/Configuration.md @@ -588,43 +588,61 @@ Removing an entry from settings file will reset it to the default value. Deletin Please follow these steps to create a new password for your user account: -1. Install `htpasswd`, which is a part of *Apache2 Web Server*: +1. Install `htpasswd`, which is a part of *Apache2 Web Server:* - Ubuntu: + * Ubuntu: - `sudo apt-get install apache2` + ```sh + sudo apt-get install apache2 + ``` - Fedora: + * Fedora: - `sudo dnf install apache2` + ```sh + sudo dnf install httpd-tools + ``` - Windows: + * Windows: - > Choose a download from https://httpd.apache.org/docs/current/platform/windows.html#down, extract the downloaded folder, open a terminal, navigate to its `bin` folder with the `cd` command, and run `.\Htpasswd` (Note the capital H in the Windows version). + Choose a download from + , + extract the downloaded folder, open a terminal, navigate to its `bin` + directory with the `chdir` command, and run `.\Htpasswd`. Note the + capital “H” in the Windows version. - Other versions of `htpasswd` could be used, but **only** if they support *bcrypt* hash encryption, which rules out e.g. most web-hosted `htpasswd` generators. + Other versions of `htpasswd` could be used, but **only** if they support + *bcrypt* hash encryption, which rules out e.g. most web-hosted `htpasswd` + generators. -2. Use the `htpasswd` utility to generate a new hash: +2. Use the `htpasswd` utility to generate a new hash: - Ubuntu/Fedora: + * Ubuntu/Fedora: - `htpasswd -B -n -b ` + ```sh + htpasswd -B -n -b + ``` - Windows: + * Windows: - `.\Htpasswd -B -n -b ` + ```ps1 + .\Htpasswd -B -n -b + ``` It will print `:` to the terminal. -3. Open `AdGuardHome.yaml` in a text editor with sudo rights. +3. Open `AdGuardHome.yaml` in a text editor with sudo rights. - In the `users:` section, find your username and insert the `` value for the `password` setting: + In the `users:` section, find your username and insert the `` value + for the `password` setting: - ```users: - - name: ... - password: ``` + ```yaml + users: + - name: ... + password: ``` + ``` -4. Save the file, restart AGH. Now you'll be able to log in to the Web interface using your new password. +4. Save the file and restart AdGuard Home. Now you should be able to log in to + the web interface using your new password. diff --git a/FAQ.md b/FAQ.md index ce0faeb..e40448d 100644 --- a/FAQ.md +++ b/FAQ.md @@ -491,6 +491,8 @@ Linux and Windows for AMD64 CPUs. cp -r ./AdGuardHome.yaml ./data ~/my-agh-backup/ ``` + (Add `./leases.db` if it is present.) + 1. Unpack the AdGuard Home archive to a temporary directory. For example, if you downloaded the archive to your `~/Downloads` directory and want to unpack it to `/tmp/`: @@ -568,6 +570,8 @@ In all examples below, the PowerShell must be run as Administrator. Copy-Item -Path .\AdGuardHome.yaml, .\data -Destination $newDir -Recurse ``` + (Add `.\leases.db` if it is present.) + 1. Unpack the AdGuard Home archive to a temporary directory. For example, if you downloaded the archive to your `Downloads` directory and want to unpack it to a temporary directory: