[AGM-2402] Update AdGuard for Linux

docs/adguard-for-linux/installation.md

@@ -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
@@ -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
+
+    adguard-cli config get
+
+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
 

docs/adguard-for-linux/settings.md

@@ -3,34 +3,56 @@ title: Settings and protection management
 sidebar_position: 3
 ---
 
+## Available commands
+
 To get a list of all available AdGuard commands, enter:
 
     adguard-cli --help-all
 
 ## Enable and disable protection
 
+### Enable protection
+
 To enable protection, enter:
 
     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
 
+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
 
-## Check for updates
+![Status/Stop protection *border](https://cdn.adtidy.org/content/Kb/ad_blocker/linux/activation6.png)
+
+## Updates
+
+### Check for updates
 
 To check for updates, enter:
 
     adguard-cli check-update
 
+### Update AdGuard for Linux
+
 To update AdGuard for Linux, enter:
 
     adguard-cli update
 
+### Update script output
+
 To view the update script output, enter:
 
     adguard-cli update -v
@@ -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)
+
 - `set`: Configure an option in `proxy.yaml`
     - `listen_ports.http_proxy`: HTTP listening port
     - `proxy_mode`: Proxy mode (`manual` or `auto`)
@@ -51,7 +76,13 @@ 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