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
parent
ef0d16e7fd
commit
34d124e1c7
|
@ -39,7 +39,7 @@ you may need to restart AdGuard Home to apply the changes.
|
||||||
|
|
||||||
![](images/top-clients-names.png)
|
![](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.
|
[`clients.runtime_sources`][sources] object of the configuration file.
|
||||||
|
|
||||||
[whois]: https://en.wikipedia.org/wiki/WHOIS
|
[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`.
|
* **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
|
(requires a [wildcard certificate][wild]). **NOTE:** The URL ClientID
|
||||||
has higher priority than the server-name ClientID. If you use both,
|
has higher priority than the server-name ClientID. If you use both,
|
||||||
only the URL ClientID is used.
|
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:
|
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:
|
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.
|
It will print `<USERNAME>:<HASH>` 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 `<HASH>` value for the `password` setting:
|
In the `users:` section, find your username and insert the `<HASH>` value
|
||||||
|
for the `password` setting:
|
||||||
|
|
||||||
```users:
|
```yaml
|
||||||
- name: ...
|
users:
|
||||||
password: <HASH>```
|
- 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
4
FAQ.md
|
@ -491,6 +491,8 @@ Linux and Windows for AMD64 CPUs.
|
||||||
cp -r ./AdGuardHome.yaml ./data ~/my-agh-backup/
|
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
|
1. Unpack the AdGuard Home archive to a temporary directory. For example, if
|
||||||
you downloaded the archive to your `~/Downloads` directory and want to
|
you downloaded the archive to your `~/Downloads` directory and want to
|
||||||
unpack it to `/tmp/`:
|
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
|
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
|
1. Unpack the AdGuard Home archive to a temporary directory. For example, if
|
||||||
you downloaded the archive to your `Downloads` directory and want to
|
you downloaded the archive to your `Downloads` directory and want to
|
||||||
unpack it to a temporary directory:
|
unpack it to a temporary directory:
|
||||||
|
|
Loading…
Reference in New Issue