Pull request: 5000-5001-passwd-fedora

Updates AdguardTeam/AdGuardHome#5000.
Updates AdguardTeam/AdGuardHome#5001.

Squashed commit of the following:

commit ef7dd9c3d5864f15b3ff1558b6aecbb2ea6e1651
Author: Ainar Garipov <A.Garipov@AdGuard.COM>
Date:   Wed Oct 5 18:36:22 2022 +0300

    all: imp passwd reset, clients; mention leases.db
Ainar Garipov 2022-10-05 18:51:27 +03:00
parent ef0d16e7fd
commit 34d124e1c7
3 changed files with 43 additions and 21 deletions

@ -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.

@ -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
<https://httpd.apache.org/docs/current/platform/windows.html#down>,
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:
Ubuntu/Fedora:
* Ubuntu/Fedora:
`htpasswd -B -n -b <USERNAME> <PASSWORD>`
```sh
htpasswd -B -n -b <USERNAME> <PASSWORD>
```
Windows:
* Windows:
`.\Htpasswd -B -n -b <USERNAME> <PASSWORD>`
```ps1
.\Htpasswd -B -n -b <USERNAME> <PASSWORD>
```
It will print `<USERNAME>:<HASH>` to the terminal.
3. Open `AdGuardHome.yaml` in a text editor with sudo rights.
In the `users:` section, find your username and insert the `<HASH>` value for the `password` setting:
In the `users:` section, find your username and insert the `<HASH>` value
for the `password` setting:
```users:
```yaml
users:
- name: ...
password: <HASH>```
```
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.

4
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: