Repository: AdguardTeam/KnowledgeBase
Pull request #673: [AGM-2402] Update AdGuard for Linux
Author: login: puglieri
Created: 2025-03-27T09:46:58Z | Merged: 2025-04-29T14:15:33Z



Diff:
diff --git a/docs/adguard-for-linux/installation.md b/docs/adguard-for-linux/installation.md
index b97db56233c..c875dfbe092 100644
--- a/docs/adguard-for-linux/installation.md
+++ b/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,29 +37,97 @@ 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
 
@@ -59,14 +135,20 @@ 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.
diff --git a/docs/adguard-for-linux/settings.md b/docs/adguard-for-linux/settings.md
index 9c691945623..08ded4647a7 100644
--- a/docs/adguard-for-linux/settings.md
+++ b/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.
diff --git a/docs/adguard-for-linux/vpn-cli-interaction.md b/docs/adguard-for-linux/vpn-cli-interaction.md
new file mode 100644
index 00000000000..1fac57de8bb
--- /dev/null
+++ b/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.


Reviews:
user: login: el-termikael
state: CHANGES_REQUESTED
author_association: CONTRIBUTOR
submitted_at: 2025-03-27T12:19:32Z
user: login: puglieri
state: COMMENTED
author_association: CONTRIBUTOR
submitted_at: 2025-03-31T06:58:06Z
user: login: ainar-g
state: APPROVED
author_association: CONTRIBUTOR
submitted_at: 2025-04-01T13:43:36Z
user: login: el-termikael
state: APPROVED
author_association: CONTRIBUTOR
submitted_at: 2025-04-02T09:13:15Z
user: login: el-termikael
state: CHANGES_REQUESTED
author_association: CONTRIBUTOR
submitted_at: 2025-04-02T11:29:34Z
user: login: ngorskikh
state: CHANGES_REQUESTED
author_association: MEMBER
submitted_at: 2025-04-22T12:46:41Z
user: login: ngorskikh
state: APPROVED
author_association: MEMBER
submitted_at: 2025-04-24T11:55:48Z
user: login: el-termikael
state: CHANGES_REQUESTED
author_association: CONTRIBUTOR
submitted_at: 2025-04-25T14:44:32Z
user: login: sfionov
state: APPROVED
author_association: MEMBER
submitted_at: 2025-04-28T17:03:14Z
user: login: sfionov
state: CHANGES_REQUESTED
author_association: MEMBER
submitted_at: 2025-04-29T04:57:52Z
user: login: sfionov
state: APPROVED
author_association: MEMBER
submitted_at: 2025-04-29T13:29:59Z
user: login: el-termikael
state: APPROVED
author_association: CONTRIBUTOR
submitted_at: 2025-04-29T14:04:12Z

Review comments:
diff_hunk: @@ -5,6 +5,8 @@ sidebar_position: 2
 
 ## Install AdGuard for Linux
 
+Before starting, you have to open the command line in your computer. On Linux, press `Ctrl+Alt+T`. On Mac, type `Terminal` in the search field.
path: docs/adguard-for-linux/installation.md
user: login: el-termikael
body: ```suggestion
Open the command line on your computer. On Linux, press `Ctrl+Alt+T`. On Mac, type `Terminal` in the search field.
```
created_at: 2025-03-27T12:06:08Z
author_association: CONTRIBUTOR
diff_hunk: @@ -5,6 +5,8 @@ sidebar_position: 2
 
 ## Install AdGuard for Linux
 
+Before starting, you have to open the command line in your computer. On Linux, press `Ctrl+Alt+T`. On Mac, type `Terminal` in the search field.
+
 To install AdGuard, enter:
 
 Release
path: docs/adguard-for-linux/installation.md
user: login: el-termikael
body: это команда для терминала?
created_at: 2025-03-27T12:06:32Z
author_association: CONTRIBUTOR
diff_hunk: @@ -29,29 +31,77 @@ 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:
path: docs/adguard-for-linux/installation.md
user: login: el-termikael
body: ```suggestion
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:
```
created_at: 2025-03-27T12:08:26Z
author_association: CONTRIBUTOR
diff_hunk: @@ -29,29 +31,77 @@ 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
path: docs/adguard-for-linux/installation.md
user: login: el-termikael
body: ```suggestion
1. After installation, enter:
```
created_at: 2025-03-27T12:08:36Z
author_association: CONTRIBUTOR
diff_hunk: @@ -29,29 +31,77 @@ 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
 
     adguard-cli activate
 
-To reset your license, enter:
+and 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:
+
+![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)
+
+You can also reset your license by entering
path: docs/adguard-for-linux/installation.md
user: login: el-termikael
body: ```suggestion
You can also reset your license by entering:
```
created_at: 2025-03-27T12:09:31Z
author_association: CONTRIBUTOR
diff_hunk: @@ -29,29 +31,77 @@ 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
 
     adguard-cli activate
 
-To reset your license, enter:
+and 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:
+
+![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)
+
+You can also reset your license by entering
 
     adguard-cli reset-license
 
-To view the license info, enter:
+or  view the license info by entering
path: docs/adguard-for-linux/installation.md
user: login: el-termikael
body: ```suggestion
or view the license info by entering:
```
created_at: 2025-03-27T12:09:42Z
author_association: CONTRIBUTOR
diff_hunk: @@ -29,29 +31,77 @@ 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
 
     adguard-cli activate
path: docs/adguard-for-linux/installation.md
user: login: el-termikael
body: думаю, команды для терминала стоит выделять ``
created_at: 2025-03-27T12:10:10Z
author_association: CONTRIBUTOR
diff_hunk: @@ -29,29 +31,77 @@ 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
 
     adguard-cli activate
 
-To reset your license, enter:
+and 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:
+
+![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)
+
+You can also reset your license by entering
 
     adguard-cli reset-license
 
-To view the license info, enter:
+or  view the license info by entering
 
     adguard-cli license
 
-## Initial setup
+1. Now you need to set up AdGuard CLI. To run the configuration wizard, enter:
+
+    adguard-cli configure
 
-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.
+![Setup *border](https://cdn.adtidy.org/content/Kb/ad_blocker/linux/activation4.png)
 
-To run the configuration wizard, enter:
+The wizard will ask basic questions required for the initial setup.
 
-    adguard-cli configure
+1. After that, you can start the AdGuard protection by entering
path: docs/adguard-for-linux/installation.md
user: login: el-termikael
body: ```suggestion
1. After that, you can start the AdGuard protection by entering:
```
created_at: 2025-03-27T12:10:48Z
author_association: CONTRIBUTOR
diff_hunk: @@ -29,29 +31,77 @@ 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
 
     adguard-cli activate
 
-To reset your license, enter:
+and 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:
+
+![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)
+
+You can also reset your license by entering
 
     adguard-cli reset-license
 
-To view the license info, enter:
+or  view the license info by entering
 
     adguard-cli license
 
-## Initial setup
+1. Now you need to set up AdGuard CLI. To run the configuration wizard, enter:
+
+    adguard-cli configure
 
-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.
+![Setup *border](https://cdn.adtidy.org/content/Kb/ad_blocker/linux/activation4.png)
 
-To run the configuration wizard, enter:
+The wizard will ask basic questions required for the initial setup.
 
-    adguard-cli configure
+1. After that, you can start the AdGuard protection by entering
+
+    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
path: docs/adguard-for-linux/installation.md
user: login: el-termikael
body: ```suggestion
1. You can check the protection status using:
```
created_at: 2025-03-27T12:11:03Z
author_association: CONTRIBUTOR
diff_hunk: @@ -29,29 +31,77 @@ 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
 
     adguard-cli activate
 
-To reset your license, enter:
+and 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:
+
+![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)
+
+You can also reset your license by entering
 
     adguard-cli reset-license
 
-To view the license info, enter:
+or  view the license info by entering
 
     adguard-cli license
 
-## Initial setup
+1. Now you need to set up AdGuard CLI. To run the configuration wizard, enter:
+
+    adguard-cli configure
 
-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.
+![Setup *border](https://cdn.adtidy.org/content/Kb/ad_blocker/linux/activation4.png)
 
-To run the configuration wizard, enter:
+The wizard will ask basic questions required for the initial setup.
 
-    adguard-cli configure
+1. After that, you can start the AdGuard protection by entering
+
+    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
+
+    adguard-cli status
+
+and stop it with
path: docs/adguard-for-linux/installation.md
user: login: el-termikael
body: ```suggestion
and stop it with:
```
created_at: 2025-03-27T12:11:09Z
author_association: CONTRIBUTOR
diff_hunk: @@ -29,29 +31,77 @@ 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
 
     adguard-cli activate
 
-To reset your license, enter:
+and 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:
+
+![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)
+
+You can also reset your license by entering
 
     adguard-cli reset-license
 
-To view the license info, enter:
+or  view the license info by entering
 
     adguard-cli license
 
-## Initial setup
+1. Now you need to set up AdGuard CLI. To run the configuration wizard, enter:
+
+    adguard-cli configure
 
-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.
+![Setup *border](https://cdn.adtidy.org/content/Kb/ad_blocker/linux/activation4.png)
 
-To run the configuration wizard, enter:
+The wizard will ask basic questions required for the initial setup.
 
-    adguard-cli configure
+1. After that, you can start the AdGuard protection by entering
+
+    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
+
+    adguard-cli status
+
+and stop it with
+
+    adguard-cli stop
+
+![Stop protecton *border](https://cdn.adtidy.org/content/Kb/ad_blocker/linux/activation6.png)
+
+1. To check the current configuration, enter
path: docs/adguard-for-linux/installation.md
user: login: el-termikael
body: ```suggestion
1. To check the current configuration, enter:
```
created_at: 2025-03-27T12:11:15Z
author_association: CONTRIBUTOR
diff_hunk: @@ -29,29 +31,77 @@ 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
 
     adguard-cli activate
 
-To reset your license, enter:
+and 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:
+
+![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)
+
+You can also reset your license by entering
 
     adguard-cli reset-license
 
-To view the license info, enter:
+or  view the license info by entering
 
     adguard-cli license
 
-## Initial setup
+1. Now you need to set up AdGuard CLI. To run the configuration wizard, enter:
+
+    adguard-cli configure
 
-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.
+![Setup *border](https://cdn.adtidy.org/content/Kb/ad_blocker/linux/activation4.png)
 
-To run the configuration wizard, enter:
+The wizard will ask basic questions required for the initial setup.
 
-    adguard-cli configure
+1. After that, you can start the AdGuard protection by entering
+
+    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
+
+    adguard-cli status
+
+and stop it with
+
+    adguard-cli stop
+
+![Stop protecton *border](https://cdn.adtidy.org/content/Kb/ad_blocker/linux/activation6.png)
+
+1. To check the current configuration, enter
+
+    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:
+
+    adguard-cli config get
+
+or
path: docs/adguard-for-linux/installation.md
user: login: el-termikael
body: ```suggestion
or:
```
created_at: 2025-03-27T12:11:23Z
author_association: CONTRIBUTOR
diff_hunk: @@ -40,6 +62,9 @@ To view the update script output, enter:
 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)
path: docs/adguard-for-linux/settings.md
user: login: el-termikael
body: если скрин относится к - `show`: Show the current configuration in `proxy.yaml`, то нужно сделать отступ
created_at: 2025-03-27T12:18:21Z
author_association: CONTRIBUTOR
diff_hunk: @@ -40,6 +62,9 @@ To view the update script output, enter:
 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)
path: docs/adguard-for-linux/settings.md
user: login: el-termikael
body: ниже аналогично
created_at: 2025-03-27T12:18:27Z
author_association: CONTRIBUTOR
diff_hunk: @@ -5,6 +5,8 @@ sidebar_position: 2
 
 ## Install AdGuard for Linux
 
+Before starting, you have to open the command line in your computer. On Linux, press `Ctrl+Alt+T`. On Mac, type `Terminal` in the search field.
+
 To install AdGuard, enter:
 
 Release
path: docs/adguard-for-linux/installation.md
user: login: puglieri
body: это горячие клавиши, переписала в кавычках
created_at: 2025-03-31T06:58:06Z
author_association: CONTRIBUTOR
diff_hunk: @@ -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:
+
+    ![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)
 
-To reset your license, enter:
+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:
+
+    ```sh
+    adguard-cli configure
+    ```
 
-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.
+    ![Setup *border](https://cdn.adtidy.org/content/Kb/ad_blocker/linux/activation4.png)
 
-To run the configuration wizard, enter:
+    The wizard will ask basic questions required for the initial setup.
 
-    adguard-cli configure
+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:
path: docs/adguard-for-linux/installation.md
user: login: ainar-g
body: If this is an item in the same list, it should not be indented.
created_at: 2025-04-01T13:42:56Z
author_association: CONTRIBUTOR
diff_hunk: @@ -5,6 +5,8 @@ sidebar_position: 2
 
 ## Install AdGuard for Linux
 
+Before starting, you have to open the command line in your computer. On Linux, press `Ctrl+Alt+T`. On Mac, type `Terminal` in the search field.
+
 To install AdGuard, enter:
 
 Release
path: docs/adguard-for-linux/installation.md
user: login: el-termikael
body: вопрос был про строку 12 со словом Release
а горячие клавиши и вводимое слово Terminal лучше выделить курсивом. см. редполитику о том, когда кавычки используем: https://www.notion.so/adguard/0df1a9bec9464fbf88bd813312ab0c26?pvs=4#25735cd772fd4083852762bc9d2ba57a
created_at: 2025-04-02T11:29:29Z
author_association: CONTRIBUTOR
diff_hunk: @@ -51,7 +90,30 @@ 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.
path: docs/adguard-for-linux/settings.md
user: login: ngorskikh
body: All steps are `1`
created_at: 2025-04-22T12:38:21Z
author_association: MEMBER
diff_hunk: @@ -51,7 +90,30 @@ 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.
+1. Edit the config file directly.
+1. To determine the location of the config file, run `adguard-cli config show | grep "Config location"`.
+1. Look for the key `listen_address` and set its value accordingly. To listen on all available network interfaces, set the listen address to `0.0.0.0`.
path: docs/adguard-for-linux/settings.md
user: login: ngorskikh
body: Since the issue with IPv6 addresses in this field has been fixed, `::` should be included in the example:
```
To listen on all available network interfaces, set the listen address to `0.0.0.0` or `::`.
created_at: 2025-04-22T12:46:11Z
author_association: MEMBER
diff_hunk: @@ -51,7 +90,30 @@ 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.
+1. Edit the config file directly.
+1. To determine the location of the config file, run `adguard-cli config show | grep "Config location"`.
path: docs/adguard-for-linux/settings.md
user: login: ngorskikh
body: These two steps should be indented
created_at: 2025-04-22T12:46:13Z
author_association: MEMBER
diff_hunk: @@ -51,7 +90,30 @@ 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.
+1. Edit the config file directly.
+1. To determine the location of the config file, run `adguard-cli config show | grep "Config location"`.
+1. Look for the key `listen_address` and set its value accordingly. To listen on all available network interfaces, set the listen address to `0.0.0.0`.
+
+> Listening on IPv6 addresses is currently not supported
path: docs/adguard-for-linux/settings.md
user: login: ngorskikh
body: Since the issue with IPv6 addresses in this field has been fixed, this warning should be removed.
created_at: 2025-04-22T12:46:17Z
author_association: MEMBER
diff_hunk: @@ -5,23 +5,23 @@ sidebar_position: 2
 
 ## Install AdGuard for Linux
 
-Open the command line on your computer. On Linux, use the keyboard shortcut “Ctrl+Alt+T”. On Mac, type “Terminal” in the search field.
+Open the command line on your computer. On Linux, use the keyboard shortcut *Ctrl+Alt+T*. On Mac, type *Terminal* in the search field.
 
-To install AdGuard, enter:
+To install AdGuard, choose the version that better suits you (release, nightly or beta) and enter the respective command.
path: docs/adguard-for-linux/installation.md
user: login: el-termikael
body: ```suggestion
To install AdGuard, choose the version that better suits you (release, beta, or nightly) and enter the respective command.
created_at: 2025-04-25T14:38:40Z
author_association: CONTRIBUTOR
diff_hunk: @@ -51,7 +90,30 @@ 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.
path: docs/adguard-for-linux/settings.md
user: login: el-termikael
body: they should be. @puglieri please keep it the way it was
created_at: 2025-04-25T14:39:55Z
author_association: CONTRIBUTOR
diff_hunk: @@ -100,3 +100,18 @@ Use the `filters` command to configure AdGuard for Linux. Subcommands:
 
 - `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 key `listen_address` and set its value accordingly. To listen on all available network interfaces, set the listen address to `0.0.0.0` or `::`.
path: docs/adguard-for-linux/settings.md
user: login: el-termikael
body: key `listen_address` —> `listen_address` key
created_at: 2025-04-25T14:41:21Z
author_association: CONTRIBUTOR
diff_hunk: @@ -100,3 +100,18 @@ Use the `filters` command to configure AdGuard for Linux. Subcommands:
 
 - `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 key `listen_address` 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 key `listen_auth`. Set the sub-key `enabled` to `true`, and `username` and `password` to non-empty values.
path: docs/adguard-for-linux/settings.md
user: login: el-termikael
body: `listen_auth` key
`enabled` sub-key
created_at: 2025-04-25T14:42:34Z
author_association: CONTRIBUTOR
diff_hunk: @@ -0,0 +1,24 @@
+---
+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:
+
+1. 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.
+2. 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
path: docs/adguard-for-linux/vpn-cli-interaction.md
user: login: el-termikael
body: same as in another PR:
or manually configured to use AdGuard VPN CLI's SOCKS5 interface.
—>
or it must be manually configured to use the SOCKS5 interface of AdGuard VPN CLI.
created_at: 2025-04-25T14:44:07Z
author_association: CONTRIBUTOR
diff_hunk: @@ -0,0 +1,24 @@
+---
+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:
+
+1. 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.
+2. 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, which includes AdGuard VPN CLI.
path: docs/adguard-for-linux/vpn-cli-interaction.md
user: login: el-termikael
body: which includes —> including
created_at: 2025-04-25T14:44:27Z
author_association: CONTRIBUTOR
diff_hunk: @@ -0,0 +1,24 @@
+---
+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:
+
+1. Switch AdGuard CLI to **manual proxy mode**.
path: docs/adguard-for-linux/vpn-cli-interaction.md
user: login: sfionov
body: I think it is better to use subheaders here, because plain numbered list more looks like a steps, not like alternatives solutions.
created_at: 2025-04-29T04:57:44Z
author_association: MEMBER

PR comments:
user: login: github-actions[bot]
created_at: 2025-03-27T09:55:30Z
body: Preview was deployed to: https://pull-request-673.kb-adg.pages.dev/
author_association: NONE
user: login: github-actions[bot]
created_at: 2025-03-28T10:44:54Z
body: Preview was deployed to: https://pull-request-673.kb-adg.pages.dev/
author_association: NONE
user: login: github-actions[bot]
created_at: 2025-03-28T10:47:49Z
body: Preview was deployed to: https://pull-request-673.kb-adg.pages.dev/
author_association: NONE
user: login: github-actions[bot]
created_at: 2025-03-28T10:49:59Z
body: Preview was deployed to: https://pull-request-673.kb-adg.pages.dev/
author_association: NONE
user: login: github-actions[bot]
created_at: 2025-03-28T10:51:37Z
body: Preview was deployed to: https://pull-request-673.kb-adg.pages.dev/
author_association: NONE
user: login: github-actions[bot]
created_at: 2025-03-28T10:54:30Z
body: Preview was deployed to: https://pull-request-673.kb-adg.pages.dev/
author_association: NONE
user: login: github-actions[bot]
created_at: 2025-03-28T11:02:39Z
body: Preview was deployed to: https://pull-request-673.kb-adg.pages.dev/
author_association: NONE
user: login: github-actions[bot]
created_at: 2025-03-28T11:11:16Z
body: Preview was deployed to: https://pull-request-673.kb-adg.pages.dev/
author_association: NONE
user: login: github-actions[bot]
created_at: 2025-03-28T11:12:42Z
body: Preview was deployed to: https://pull-request-673.kb-adg.pages.dev/
author_association: NONE
user: login: github-actions[bot]
created_at: 2025-03-28T11:41:44Z
body: Preview was deployed to: https://pull-request-673.kb-adg.pages.dev/
author_association: NONE
user: login: github-actions[bot]
created_at: 2025-03-31T07:04:44Z
body: Preview was deployed to: https://pull-request-673.kb-adg.pages.dev/
author_association: NONE
user: login: github-actions[bot]
created_at: 2025-03-31T10:38:44Z
body: Preview was deployed to: https://pull-request-673.kb-adg.pages.dev/
author_association: NONE
user: login: github-actions[bot]
created_at: 2025-03-31T10:51:26Z
body: Preview was deployed to: https://pull-request-673.kb-adg.pages.dev/
author_association: NONE
user: login: github-actions[bot]
created_at: 2025-03-31T11:08:31Z
body: Preview was deployed to: https://pull-request-673.kb-adg.pages.dev/
author_association: NONE
user: login: github-actions[bot]
created_at: 2025-03-31T11:16:56Z
body: Preview was deployed to: https://pull-request-673.kb-adg.pages.dev/
author_association: NONE
user: login: github-actions[bot]
created_at: 2025-03-31T11:40:46Z
body: Preview was deployed to: https://pull-request-673.kb-adg.pages.dev/
author_association: NONE
user: login: github-actions[bot]
created_at: 2025-03-31T15:07:51Z
body: Preview was deployed to: https://pull-request-673.kb-adg.pages.dev/
author_association: NONE
user: login: github-actions[bot]
created_at: 2025-04-01T12:09:57Z
body: Preview was deployed to: https://pull-request-673.kb-adg.pages.dev/
author_association: NONE
user: login: github-actions[bot]
created_at: 2025-04-01T13:11:05Z
body: Preview was deployed to: https://pull-request-673.kb-adg.pages.dev/
author_association: NONE
user: login: github-actions[bot]
created_at: 2025-04-01T14:15:23Z
body: Preview was deployed to: https://pull-request-673.kb-adg.pages.dev/
author_association: NONE
user: login: github-actions[bot]
created_at: 2025-04-18T18:17:41Z
body: Preview was deployed to: https://pull-request-673.kb-adg.pages.dev/
author_association: NONE
user: login: github-actions[bot]
created_at: 2025-04-21T12:29:26Z
body: Preview was deployed to: https://pull-request-673.kb-adg.pages.dev/
author_association: NONE
user: login: github-actions[bot]
created_at: 2025-04-21T12:34:42Z
body: Preview was deployed to: https://pull-request-673.kb-adg.pages.dev/
author_association: NONE
user: login: github-actions[bot]
created_at: 2025-04-24T10:03:16Z
body: Preview was deployed to: https://pull-request-673.kb-adg.pages.dev/
author_association: NONE
user: login: github-actions[bot]
created_at: 2025-04-29T08:59:16Z
body: Preview was deployed to: https://pull-request-673.kb-adg.pages.dev/
author_association: NONE
user: login: github-actions[bot]
created_at: 2025-04-29T09:15:50Z
body: Preview was deployed to: https://pull-request-673.kb-adg.pages.dev/
author_association: NONE
user: login: github-actions[bot]
created_at: 2025-04-29T09:40:55Z
body: Preview was deployed to: https://pull-request-673.kb-adg.pages.dev/
author_association: NONE
user: login: github-actions[bot]
created_at: 2025-04-29T14:12:48Z
body: Preview was deployed to: https://pull-request-673.kb-adg.pages.dev/
author_association: NONE