[AGM-2402] Update AdGuard for Linux

docs/adguard-for-linux/installation.md

@@ -5,19 +5,27 @@ sidebar_position: 2
 
 ## Install AdGuard for Linux
 
-To install AdGuard, enter:
+Open the command line on your computer. On Linux, use the keyboard shortcut *Ctrl+Alt+T*. On Mac, type *Terminal* in the search field.
 
-Release
+To install AdGuard, choose the version that better suits you (release, beta, or nightly) and enter the respective command.
 
-    curl -fsSL https://raw.githubusercontent.com/AdguardTeam/AdGuardCLI/release/install.sh | sh -s -- -v
+**Release**:
 
-Beta
+```sh
+curl -fsSL https://raw.githubusercontent.com/AdguardTeam/AdGuardCLI/release/install.sh | sh -s -- -v
+```
 
-    curl -fsSL https://raw.githubusercontent.com/AdguardTeam/AdGuardCLI/beta/install.sh | sh -s -- -v
+**Beta**:
 
-Nightly
+```sh
+curl -fsSL https://raw.githubusercontent.com/AdguardTeam/AdGuardCLI/beta/install.sh | sh -s -- -v
+```
+
+**Nightly**:
 
-    curl -fsSL https://raw.githubusercontent.com/AdguardTeam/AdGuardCLI/nightly/install.sh | sh -s -- -v
+```sh
+curl -fsSL https://raw.githubusercontent.com/AdguardTeam/AdGuardCLI/nightly/install.sh | sh -s -- -v
+```
 
 If required, enter your admin password.
 
@@ -29,44 +37,118 @@ You can verify the signature to prove it’s an official version of AdGuard by u
 
 :::
 
-## Activate license
+## Initial setup
 
-AdGuard for Linux requires an [AdGuard license](https://adguard.com/license.html). If you don't have a license yet, you can log in or create an account to get a free 14-day trial. If you already have a license, log in to activate it.
+AdGuard for Linux requires an [AdGuard license](https://adguard.com/license.html). If you don’t have a license yet, you can log in or create an account to get a free 14-day trial. If you already have a license, log in to activate it. To do it, follow this step-by-step guide:
 
-To log in or create an account, enter:
+1. After installation, enter:
 
+    ```sh
     adguard-cli activate
+    ```
+
+1. Then select the desired option:
+
+    ![adguard-cli activate *border](https://cdn.adtidy.org/content/Kb/ad_blocker/linux/activation1.png)
+
+1. Once you have a license, follow the provided link to proceed with the activation:
 
-To reset your license, enter:
+    ![Activate license *border](https://cdn.adtidy.org/content/Kb/ad_blocker/linux/activation2.png)
 
+1. After activation, you can continue to work with the program:
+
+    ![Successful activation *border](https://cdn.adtidy.org/content/Kb/ad_blocker/linux/activation3.png)
+
+1. You can also reset your license by entering:
+
+    ```sh
     adguard-cli reset-license
+    ```
 
-To view the license info, enter:
+    or  view the license info by entering
 
+    ```sh
     adguard-cli license
+    ```
 
-## Initial setup
+1. Now you need to set up AdGuard CLI. To run the configuration wizard, enter:
 
-To get AdGuard up and running, complete the initial setup. This includes installing the AdGuard CA certificate, enabling the necessary filters, and selecting the proxy mode.
+    ```sh
+    adguard-cli configure
+    ```
 
-To run the configuration wizard, enter:
+    ![Setup *border](https://cdn.adtidy.org/content/Kb/ad_blocker/linux/activation4.png)
 
-    adguard-cli configure
+    The wizard will ask basic questions required for the initial setup.
+
+1. After that, you can start the AdGuard protection by entering
+
+    ```sh
+    adguard-cli start
+    ```
+
+    ![Start protecton *border](https://cdn.adtidy.org/content/Kb/ad_blocker/linux/activation5.png)
+
+1. You can check the protection status using:
+
+    ```sh
+    adguard-cli status
+    ```
+
+    and stop it with:
+
+    ```sh
+    adguard-cli stop
+    ```
+
+    ![Stop protecton *border](https://cdn.adtidy.org/content/Kb/ad_blocker/linux/activation6.png)
+
+1. To check the current configuration, enter:
+
+    ```sh
+    adguard-cli config show
+    ```
+
+    ![Current setup *border](https://cdn.adtidy.org/content/Kb/ad_blocker/linux/activation7.png)
+
+    The path to the configuration file will also be displayed, which you can and should edit directly. It contains descriptions of all additional options.
+
+    As an alternative, you can use the commands:
+
+    ```sh
+    adguard-cli config get
+    ```
+
+    or:
+
+    ```sh
+    adguard-cli config set
+    ```
+
+    They are primarily intended for scripting, though.
+
+For further information on the available commands, check out the section [Settings and protection management](https://adguard.com/kb/adguard-for-linux/settings/).
 
 ## Uninstall AdGuard for Linux
 
 To uninstall AdGuard, enter:
 
 Release
 
-    curl -fsSL https://raw.githubusercontent.com/AdguardTeam/AdGuardCLI/release/install.sh | sh -s -- -v -u
+```sh
+curl -fsSL https://raw.githubusercontent.com/AdguardTeam/AdGuardCLI/release/install.sh | sh -s -- -v -u
+```
 
 Beta
 
-    curl -fsSL https://raw.githubusercontent.com/AdguardTeam/AdGuardCLI/beta/install.sh | sh -s -- -v -u
+```sh
+curl -fsSL https://raw.githubusercontent.com/AdguardTeam/AdGuardCLI/beta/install.sh | sh -s -- -v -u
+```
 
 Nightly
 
-    curl -fsSL https://raw.githubusercontent.com/AdguardTeam/AdGuardCLI/nightly/install.sh | sh -s -- -v -u
+```sh
+curl -fsSL https://raw.githubusercontent.com/AdguardTeam/AdGuardCLI/nightly/install.sh | sh -s -- -v -u
+```
 
 If required, enter your admin password.

docs/adguard-for-linux/settings.md

@@ -3,43 +3,82 @@ title: Settings and protection management
 sidebar_position: 3
 ---
 
+## Available commands
+
 To get a list of all available AdGuard commands, enter:
 
-    adguard-cli --help-all
+```sh
+adguard-cli --help-all
+```
 
 ## Enable and disable protection
 
+### Enable protection
+
 To enable protection, enter:
 
-    adguard-cli start
+```sh
+adguard-cli start
+```
+
+This command attempts to configure a redirection to the proxy.
+
+![Start protection *border](https://cdn.adtidy.org/content/Kb/ad_blocker/linux/start-protection.gif)
+
+### Disable protection
 
 To disable protection, enter:
 
-    adguard-cli stop
+```sh
+adguard-cli stop
+```
+
+This command not only stops the proxy but also stops the trafic from redirecting to it.
+
+### Check protection status
 
 To view the protection status, enter:
 
-    adguard-cli status
+```sh
+adguard-cli status
+```
+
+![Status/Stop protection *border](https://cdn.adtidy.org/content/Kb/ad_blocker/linux/activation6.png)
+
+## Updates
 
-## Check for updates
+### Check for updates
 
 To check for updates, enter:
 
-    adguard-cli check-update
+```sh
+adguard-cli check-update
+```
+
+### Update AdGuard for Linux
 
 To update AdGuard for Linux, enter:
 
-    adguard-cli update
+```sh
+adguard-cli update
+```
+
+### Update script output
 
 To view the update script output, enter:
 
-    adguard-cli update -v
+```sh
+adguard-cli update -v
+```
 
 ## Configure AdGuard for Linux
 
 Use the `config` command to configure AdGuard for Linux. Subcommands:
 
 - `show`: Show the current configuration in `proxy.yaml`
+
+    ![Current setup *border](https://cdn.adtidy.org/content/Kb/ad_blocker/linux/activation7.png)
+
 - `set`: Configure an option in `proxy.yaml`
     - `listen_ports.http_proxy`: HTTP listening port
     - `proxy_mode`: Proxy mode (`manual` or `auto`)
@@ -51,7 +90,28 @@ Use the `filters` command to configure AdGuard for Linux. Subcommands:
 
 - `list`: List installed filters
     - `--all`: View all filters
+
+    ![Filter list *border](https://cdn.adtidy.org/content/Kb/ad_blocker/linux/filter-list.png)
+
 - `install`: Install a filter. Enter the URL of the filter you want to install
 - `enable`: Enable a filter. Enter the name or ID of the filter
+
+    ![Enable filters *border](https://cdn.adtidy.org/content/Kb/ad_blocker/linux/built-in-filters.png)
+
 - `disable`: Disable a filter. Enter the name or ID of the filter
 - `update`: Update filters
+
+## Changing the proxy server listen address in manual proxy mode
+
+By default, the proxy server listens on `127.0.0.1` — the address of the loopback network interface.
+There are two ways to make the proxy server listen on a different interface:
+
+1. Run `adguard-cli config set listen_address <address>` where `<address>` is the address to listen on.
+2. Edit the config file directly:
+    - To determine the location of the config file, run `adguard-cli config show | grep "Config location"`.
+    - Look for the `listen_address` key and set its value accordingly. To listen on all available network interfaces, set the listen address to `0.0.0.0` or `::`.
+
+If the listen address is set to anything other than `127.0.0.1`, then proxy client authentication is required. AdGuard CLI will not start unless proxy authentication is configured:
+
+- When running `adguard-cli config set listen_address <address>` where `<address>` is not `127.0.0.1`, AdGuard CLI will prompt for a username and password if proxy authentication is not already configured.
+- When editing the config file directly, look for the `listen_auth`key. Set the `enabled` sub-key to `true`, and `username` and `password` to non-empty values.

docs/adguard-for-linux/vpn-cli-interaction.md

@@ -0,0 +1,16 @@
+---
+title: AdGuard VPN CLI interaction
+sidebar_position: 5
+---
+
+## AdGuard VPN CLI interaction
+
+Using AdGuard CLI in **automatic proxy mode** together with AdGuard VPN CLI in **tunnel mode** is impossible due to a routing loop: AdGuard VPN CLI's traffic currently can not be excluded from being transparently proxied by AdGuard CLI, and AdGuard CLI's traffic must go through the AdGuard VPN CLI's tunnel.
+
+These are the two possible solutions:
+
+- Switch AdGuard CLI to **manual proxy mode**.
+    - In this case, AdGuard VPN CLI can be used in **tunnel mode**, but apps for which ad blocking is desired must be manually configured to use the AdGuard CLI's proxy.
+- Switch AdGuard VPN CLI to **SOCKS5 mode**, and configure AdGuard CLI with an outbound proxy pointing to the SOCKS5 interface of AdGuard VPN CLI. In this case, it's important to keep in mind that:
+    - For an app's traffic to go through the VPN tunnel it must either have its traffic transparently proxied by AdGuard CLI (which is the case for all apps by default), or manually configured to use AdGuard VPN CLI's SOCKS5 interface.
+    - In order to avoid a routing loop, the `skip_outbound_proxy` option must be enabled for AdGuard VPN CLI in AdGuard CLI's apps configuration section. By default, `skip_outbound_proxy` is enabled for all apps with `vpn` in their name, including AdGuard VPN CLI.