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)
|
||||
|
||||
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
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:
|
||||
|
|
Loading…
Reference in New Issue