1"use strict";(self.webpackChunkadguard_knowledge_base=self.webpackChunkadguard_knowledge_base||[]).push([["2426"],{33468(e,n,i){i.r(n),i.d(n,{metadata:()=>s,default:()=>h,frontMatter:()=>d,contentTitle:()=>l,toc:()=>o,assets:()=>a});var s=JSON.parse('{"id":"adguard-for-linux/settings","title":"Settings and protection management","description":"Available commands","source":"@site/docs/adguard-for-linux/settings.md","sourceDirName":"adguard-for-linux","slug":"/adguard-for-linux/settings","permalink":"/adguard-for-linux/settings","draft":false,"unlisted":false,"editUrl":"https://github.com/AdguardTeam/KnowledgeBase/edit/master/docs/adguard-for-linux/settings.md","tags":[],"version":"current","sidebarPosition":3,"frontMatter":{"title":"Settings and protection management","sidebar_position":3},"sidebar":"tutorialSidebar","previous":{"title":"Installation, setup, and removal","permalink":"/adguard-for-linux/installation"},"next":{"title":"Sending feedback","permalink":"/adguard-for-linux/feedback"}}'),r=i(86070),t=i(91704);let d={title:"Settings and protection management",sidebar_position:3},l,a={},o=[{value:"Available commands",id:"available-commands",level:2},{value:"Enable and disable protection",id:"enable-and-disable-protection",level:2},{value:"Enable protection",id:"enable-protection",level:3},{value:"Disable protection",id:"disable-protection",level:3},{value:"Check protection status",id:"check-protection-status",level:3},{value:"Restart protection",id:"restart-protection",level:3},{value:"Updates",id:"updates",level:2},{value:"Check for updates",id:"check-for-updates",level:3},{value:"Update AdGuard for Linux",id:"update-adguard-for-linux",level:3},{value:"Update script output",id:"update-script-output",level:3},{value:"Configure AdGuard for Linux",id:"configure-adguard-for-linux",level:2},{value:"Manage filters",id:"manage-filters",level:2},{value:"Manage DNS filters",id:"manage-dns-filters",level:2},{value:"Manage userscripts",id:"manage-userscripts",level:2},{value:"Changing the proxy server listen address in manual proxy mode",id:"changing-the-proxy-server-listen-address-in-manual-proxy-mode",level:2},{value:"Configure outbound proxy",id:"configure-outbound-proxy",level:2},{value:"1. Configure via URL (recommended)",id:"1-configure-via-url-recommended",level:3},{value:"2. Configure individual parameters",id:"2-configure-individual-parameters",level:3},{value:"Per-app AdGuard CLI configuration",id:"per-app-adguard-cli-configuration",level:2},{value:"Checking the current configuration",id:"checking-the-current-configuration",level:3},{value:"Export and import settings",id:"export-and-import-settings",level:2},{value:"Export settings",id:"export-settings",level:3},{value:"Import settings",id:"import-settings",level:3},{value:"AdGuard Browser Assistant",id:"adguard-browser-assistant",level:2},{value:"How it works",id:"how-it-works",level:3},{value:"How to install",id:"how-to-install",level:3}];function c(e){let n={a:"a",admonition:"admonition",code:"code",em:"em",h2:"h2",h3:"h3",img:"img",li:"li",ol:"ol",p:"p",pre:"pre",strong:"strong",ul:"ul",...(0,t.R)(),...e.components};return(0,r.jsxs)(r.Fragment,{children:[(0,r.jsx)(n.h2,{id:"available-commands",children:"Available commands"}),"\n",(0,r.jsx)(n.p,{children:"To get a list of all available AdGuard commands, enter:"}),"\n",(0,r.jsx)(n.pre,{children:(0,r.jsx)(n.code,{className:"language-sh",children:"adguard-cli --help-all\n"})}),"\n",(0,r.jsx)(n.h2,{id:"enable-and-disable-protection",children:"Enable and disable protection"}),"\n",(0,r.jsx)(n.h3,{id:"enable-protection",children:"Enable protection"}),"\n",(0,r.jsx)(n.p,{children:"To enable protection, enter:"}),"\n",(0,r.jsx)(n.pre,{children:(0,r.jsx)(n.code,{className:"language-sh",children:"adguard-cli start\n"})}),"\n",(0,r.jsx)(n.p,{children:"This command attempts to configure a redirection to the proxy."}),"\n",(0,r.jsx)(n.p,{children:(0,r.jsx)(n.img,{src:"https://cdn.adtidy.org/content/Kb/ad_blocker/linux/start-protection.gif",alt:"Start protection *border"})}),"\n",(0,r.jsx)(n.h3,{id:"disable-protection",children:"Disable protection"}),"\n",(0,r.jsx)(n.p,{children:"To disable protection, enter:"}),"\n",(0,r.jsx)(n.pre,{children:(0,r.jsx)(n.code,{className:"language-sh",children:"adguard-cli stop\n"})}),"\n",(0,r.jsx)(n.p,{children:"This command not only stops the proxy but also stops the traffic from redirecting to it."}),"\n",(0,r.jsx)(n.h3,{id:"check-protection-status",children:"Check protection status"}),"\n",(0,r.jsx)(n.p,{children:"To view the protection status, enter:"}),"\n",(0,r.jsx)(n.pre,{children:(0,r.jsx)(n.code,{className:"language-sh",children:"adguard-cli status\n"})}),"\n",(0,r.jsx)(n.p,{children:(0,r.jsx)(n.img,{src:"https://cdn.adtidy.org/content/Kb/ad_blocker/linux/6status-stop.png",alt:"Status/Stop protection *border"})}),"\n",(0,r.jsx)(n.h3,{id:"restart-protection",children:"Restart protection"}),"\n",(0,r.jsx)(n.p,{children:"To restart the proxy server and reapply settings, enter:"}),"\n",(0,r.jsx)(n.pre,{children:(0,r.jsx)(n.code,{className:"language-sh",children:"adguard-cli restart\n"})}),"\n",(0,r.jsx)(n.h2,{id:"updates",children:"Updates"}),"\n",(0,r.jsx)(n.h3,{id:"check-for-updates",children:"Check for updates"}),"\n",(0,r.jsx)(n.p,{children:"To check for updates, enter:"}),"\n",(0,r.jsx)(n.pre,{children:(0,r.jsx)(n.code,{className:"language-sh",children:"adguard-cli check-update\n"})}),"\n",(0,r.jsx)(n.h3,{id:"update-adguard-for-linux",children:"Update AdGuard for Linux"}),"\n",(0,r.jsx)(n.p,{children:"To update AdGuard for Linux, enter:"}),"\n",(0,r.jsx)(n.pre,{children:(0,r.jsx)(n.code,{className:"language-sh",children:"adguard-cli update\n"})}),"\n",(0,r.jsx)(n.h3,{id:"update-script-output",children:"Update script output"}),"\n",(0,r.jsx)(n.p,{children:"To view the update script output, enter
1:"}),"\n",(0,r.jsx)(n.pre,{children:(0,r.jsx)(n.code,{className:"language-sh",children:"adguard-cli update -v\n"})}),"\n",(0,r.jsx)(n.h2,{id:"configure-adguard-for-linux",children:"Configure AdGuard for Linux"}),"\n",(0,r.jsxs)(n.p,{children:["Use the ",(0,r.jsx)(n.code,{children:"config"})," command to configure AdGuard for Linux. Subcommands:"]}),"\n",(0,r.jsxs)(n.ul,{children:["\n",(0,r.jsxs)(n.li,{children:["\n",(0,r.jsxs)(n.p,{children:[(0,r.jsx)(n.code,{children:"show [<section-name>]"}),": Show the current configuration in ",(0,r.jsx)(n.code,{children:"proxy.yaml"})," (or a specific section)"]}),"\n",(0,r.jsx)(n.p,{children:(0,r.jsx)(n.img,{src:"https://cdn.adtidy.org/content/Kb/ad_blocker/linux/7config_show.png",alt:"Current setup *border"})}),"\n"]}),"\n",(0,r.jsxs)(n.li,{children:["\n",(0,r.jsxs)(n.p,{children:[(0,r.jsx)(n.code,{children:"set <key> <value>"}),": Configure an option in ",(0,r.jsx)(n.code,{children:"proxy.yaml"})]}),"\n",(0,r.jsxs)(n.ul,{children:["\n",(0,r.jsxs)(n.li,{children:[(0,r.jsx)(n.code,{children:"listen_ports.http_proxy"}),": HTTP listening port"]}),"\n",(0,r.jsxs)(n.li,{children:[(0,r.jsx)(n.code,{children:"proxy_mode"}),": Proxy mode (",(0,r.jsx)(n.code,{children:"manual"})," or ",(0,r.jsx)(n.code,{children:"auto"}),")"]}),"\n"]}),"\n"]}),"\n",(0,r.jsxs)(n.li,{children:["\n",(0,r.jsxs)(n.p,{children:[(0,r.jsx)(n.code,{children:"get <key>"}),": Get the current status of a setting"]}),"\n"]}),"\n",(0,r.jsxs)(n.li,{children:["\n",(0,r.jsxs)(n.p,{children:[(0,r.jsx)(n.code,{children:"list-add <key> <value> [<value>...]"}),": Add one or more values to a list setting"]}),"\n"]}),"\n",(0,r.jsxs)(n.li,{children:["\n",(0,r.jsxs)(n.p,{children:[(0,r.jsx)(n.code,{children:"list-remove <key> <value>"}),": Remove a value from a list setting"]}),"\n"]}),"\n",(0,r.jsxs)(n.li,{children:["\n",(0,r.jsxs)(n.p,{children:[(0,r.jsx)(n.code,{children:"reset <key>"}),": Reset a setting to its default value"]}),"\n"]}),"\n",(0,r.jsxs)(n.li,{children:["\n",(0,r.jsxs)(n.p,{children:[(0,r.jsx)(n.code,{children:"reset --all"}),": Reset all settings to their default values"]}),"\n"]}),"\n"]}),"\n",(0,r.jsxs)(n.admonition,{type:"note",children:[(0,r.jsx)(n.p,{children:"The Automatic mode can only be used if the following requirements are met:"}),(0,r.jsxs)(n.ul,{children:["\n",(0,r.jsxs)(n.li,{children:[(0,r.jsx)(n.code,{children:"iptables"})," is installed and running (either ",(0,r.jsx)(n.code,{children:"nft"})," or ",(0,r.jsx)(n.code,{children:"legacy"}),")"]}),"\n",(0,r.jsxs)(n.li,{children:[(0,r.jsx)(n.code,{children:"iptables"})," supports the ",(0,r.jsx)(n.code,{children:"nat"})," table for both IPv4 and IPv6"]}),"\n",(0,r.jsxs)(n.li,{children:[(0,r.jsx)(n.code,{children:"iptables"})," supports the ",(0,r.jsx)(n.code,{children:"REDIRECT"})," and ",(0,r.jsx)(n.code,{children:"QUEUE"})," chains for both IPv4 and IPv6"]}),"\n",(0,r.jsxs)(n.li,{children:["The ",(0,r.jsx)(n.code,{children:"sudo"})," package is installed"]}),"\n"]})]}),"\n",(0,r.jsx)(n.h2,{id:"manage-filters",children:"Manage filters"}),"\n",(0,r.jsxs)(n.p,{children:["Use the ",(0,r.jsx)(n.code,{children:"filters"})," command to configure AdGuard for Linux. Subcommands:"]}),"\n",(0,r.jsxs)(n.ul,{children:["\n",(0,r.jsxs)(n.li,{children:["\n",(0,r.jsxs)(n.p,{children:[(0,r.jsx)(n.code,{children:"list"}),": List installed and added filters"]}),"\n",(0,r.jsxs)(n.ul,{children:["\n",(0,r.jsxs)(n.li,{children:[(0,r.jsx)(n.code,{children:"--all"}),": View all filters"]}),"\n"]}),"\n",(0,r.jsx)(n.p,{children:(0,r.jsx)(n.img,{src:"https://cdn.adtidy.org/content/Kb/ad_blocker/linux/filter-list.png",alt:"Filter list *border"})}),"\n"]}),"\n",(0,r.jsxs)(n.li,{children:["\n",(0,r.jsxs)(n.p,{children:[(0,r.jsx)(n.code,{children:"add"}),": Add a built-in filter by ID or name"]}),"\n"]}),"\n",(0,r.jsxs)(n.li,{children:["\n",(0,r.jsxs)(n.p,{children:[(0,r.jsx)(n.code,{children:"install"}),": Install a filter. Enter the URL of the filter you want to install or local file"]}),"\n",(0,r.jsxs)(n.ul,{children:["\n",(0,r.jsxs)(n.li,{children:[(0,r.jsx)(n.code,{children:"--trusted"}),": Mark the custom filter as trusted"]}),"\n",(0,r.jsxs)(n.li,{children:[(0,r.jsx)(n.code,{children:"--title"}),": Set a custom title for the filter"]}),"\n"]}),"\n"]}),"\n",(0,r.jsxs)(n.li,{children:["\n",(0,r.jsxs)(n.p,{children:[(0,r.jsx)(n.code,{children:"enable"}),": Enable a filter. Enter the name or ID of the filter"]}),"\n",(0,r.jsx)(n.p,{children:(0,r.jsx)(n.img,{src:"https://cdn.adtidy.org/content/Kb/ad_blocker/linux/built-in-filters.png",alt:"Enable filters *border"})}),"\n"]}),"\n",(0,r.jsxs)(n.li,{children:["\n",(0,r.jsxs)(n.p,{children:[(0,r.jsx)(n.code,{children:"disable"}),": Disable a filter. Enter the name or ID of the filter"]}),"\n"]}),"\n",(0,r.jsxs)(n.li,{children:["\n",(0,r.jsxs)(n.p,{children:[(0,r.jsx)(n.code,{children:"remove"}),": Remove an internal or custom filter by ID"]}),"\n"]}),"\n",(0,r.jsxs)(n.li,{children:["\n",(0,r.jsxs)(n.p,{children:[(0,r.jsx)(n.code,{children:"set-trusted"}),": Mark a custom filter as trusted or untrusted"]}),"\n"]}),"\n",(0,r.jsxs)(n.li,{children:["\n",(0,r.jsxs)(n.p,{children:[(0,r.jsx)(n.code,{children:"set-title"}),": Set a custom title for a custom filter"]}),"\n"]}),"\n"]}),"\n",(0,r.jsxs)(n.p,{children:["Filter updates are handled by ",(0,r.jsx)(n.code,{children:"adguard-cli check-update"})," (the ",(0,r.jsx)(n.code,{children:"filters update"})," subcommand forwards to it)."]}),"\n",(0,r.jsx)(n.h2,{id:"manage-dns-filters",children:"Manage DNS filters"}),"\n",(0,r.jsxs)(n.p,{children:["Use the ",(0,r.jsx)(n.code,{children:"dns filters"})," command to manage DNS filter lists. Subcommands:"]}),"\n",(0,r.jsxs)(n.ul,{children:["\n",(0,r.jsxs)(n.li,{children:[(0,r.jsx)(n.code,{children:"list"}),": List installed and added DNS filters","\n",(0,r.jsxs)(n.ul,{children:["\n",(0,r.jsxs)(n.li,{children:[(0,r.jsx)(n.code,{children:"--all"}),": View all DNS filters"]}),"\n"]}),"\n"]}),"\n",(0,r.jsxs)(n.li,{children:[(0,r.jsx)(n.code,{children:"add"}),": Add a built-in DNS filter by ID or name"]}),"\n",(0,r.jsxs)(n.li,{children:[(0,r.jsx)(n.code,{children:"install"}),": Install a custom DNS filter from a URL or local file","\n",(0,r.jsxs)(n.ul,{children:["\n",(0,r.jsxs)(n.li,{children:[(0,r.jsx)(n.code,{children:"--title"}),": Set a custom title for the filter"]}),"\n"]}),"\n"]}),"\n",(0,r.jsxs)(n.li,{children:[(0,r.jsx)(n.code,{children:"enable"}),": Enable a DNS filter. Enter the name or ID of the filter"]}),"\n",(0,r.jsxs)(n.li,{children:[(0,r.jsx)(n.code,{children:"disable"}),": Disable a DNS filter. Enter the name or ID of the filter"]}),"\n",(0,r.jsxs)(n.li,{children:[(0,r.jsx)(n.code,{children:"remove"}),": Remove a DNS filter by ID"]}),"\n",(0,r.jsxs)(n.li,{children:[(0,r.jsx)(n.code,{children:"set-title"}),": Set a custom title for a DNS filter"]}),"\n"]}),"\n",(0,r.jsxs)(n.p,{children:["DNS filter updates are handled by ",(0,r.jsx)(n.code,{children:"adguard-cli check-update"}),"."]}),"\n",(0,r.jsx)(n.h2,{id:"manage-userscripts",children:"Manage userscripts"}),"\n",(0,r.jsxs)(n.p,{children:["Use the ",(0,r.jsx)(n.code,{children:"userscripts"})," command to manage userscripts. Subcommands:"]}),"\n",(0,r.jsxs)(n.ul,{children:["\n",(0,r.jsxs)(n.li,{children:[(0,r.jsx)(n.code,{children:"list"}),": Show installed userscripts"]}),"\n",(0,r.jsxs)(n.li,{children:[(0,r.jsx)(n.code,{children:"install"}),": Install a userscript from a URL"]}),"\n",(0,r.jsxs)(n.li,{children:[(0,r.jsx)(n.code,{children:"remove"}),": Remove a userscript"]}),"\n",(0,r.jsxs)(n.li,{children:[(0,r.jsx)(n.code,{children:"enable"}),": Enable a userscript"]}),"\n",(0,r.jsxs)(n.li,{children:[(0,r.jsx)(n.code,{children:"disable"}),": Disable a userscript"]}),"\n"]}),"\n",(0,r.jsxs)(n.p,{children:["Userscripts are updated by ",(0,r.jsx)(n.code,{children:"adguard-cli check-update"}),"."]}),"\n",(0,r.jsx)(n.h2,{id:"changing-the-proxy-server-listen-address-in-manual-proxy-mode",children:"Changing the proxy server listen address in manual proxy mode"}),"\n",(0,r.jsxs)(n.p,{children:["By default, the proxy server listens on ",(0,r.jsx)(n.code,{children:"127.0.0.1"})," \u2014 the address of the loopback network interface.\nThere are two ways to make the proxy server listen on a different interface:"]}),"\n",(0,r.jsxs)(n.ol,{children:["\n",(0,r.jsxs)(n.li,{children:["Run ",(0,r.jsx)(n.code,{children:"adguard-cli config set listen_address <address>"})," where ",(0,r.jsx)(n.code,{children:"<address>"})," is the address to listen on."]}),"\n",(0,r.jsxs)(n.li,{children:["Edit the config file directly:","\n",(0,r.jsxs)(n.ul,{children:["\n",(0,r.jsxs)(n.li,{children:["To determine the location of the config file, run ",(0,r.jsx)(n.code,{children:'adguard-cli config show | grep "Config location"'}),"."]}),"\n",(0,r.jsxs)(n.li,{children:["Look for the ",(0,r.jsx)(n.code,{children:"listen_address"})," key and set its value accordingly. To listen on all available network interfaces, set the listen address to ",(0,r.jsx)(n.code,{children:"0.0.0.0"})," or ",(0,r.jsx)(n.code,{children:"::"}),"."]}),"\n"]}),"\n"]}),"\n"]}),"\n",(0,r.jsxs)(n.p,{children:["If the listen address is set to anything other than ",(0,r.jsx)(n.code,{children:"127.0.0.1"}),", then proxy client authentication is required. AdGuard CLI will not start unless proxy authentication is configured:"]}),"\n",(0,r.jsxs)(n.ul,{children:["\n",(0,r.jsxs)(n.li,{children:["When running ",(0,r.jsx)(n.code,{children:"adguard-cli config set listen_address <address>"})," where ",(0,r.jsx)(n.code,{children:"<address>"})," is not ",(0,r.jsx)(n.code,{children:"127.0.0.1"}),", AdGuard CLI will prompt for a username and password if proxy authentication is not already configured."]}),"\n",(0,r.jsxs)(n.li,{children:["When editing the config file directly, look for the ",(0,r.jsx)(n.code,{children:"listen_auth"}),"key. Set the ",(0,r.jsx)(n.code,{children:"enabled"})," sub-key to ",(0,r.jsx)(n.code,{children:"true"}),", and ",(0,r.jsx)(n.code,{children:"username"})," and ",(0,r.jsx)(n.code,{children:"password"})," to non-empty values."]}),"\n"]}),"\n",(0,r.jsx)(n.h2,{id:"configure-outbound-proxy",children:"Configure outbound proxy"}),"\n",(0,r.jsxs)(n.p,{children:["You can configure ",(0,r.jsx)(n.code,{children:"outbound_proxy"})," if you want AdGuard CLI to work through another proxy server."]}),"\n",(0,r.jsx)(n.p,{children:"There are two ways to configure it:"}),"\n",(0,r.jsx)(n.h3,{id:"1-configure-via-url-recommended",children:"1. Configure via URL (recommended)"}),"\n",(0,r.jsx)(n.p,{children:"Instead of setting each option step by step, you can set all parameters in a single line using a URL:"}),"\n",(0,r.jsx)(n.pre,{children:(0,r.jsx)(n.code,{className:"language-sh",children:"adguard-cli config set outbound_proxy https://user:pass@host:port\n"})}),"\n",(0,r.jsx)(n.admonition,{type:"info",children:(0,r.jsx)(n.p,{children:"Supported modes are HTTP, HTTPS, SOCKS4, and SOCKS5."})}),"\n",(0,r.jsxs)(n.p,{children:["You can also quickly enable or disable ",(0,r.jsx)(n.code,{children:"outbound_proxy"}),":"]}),"\n",(0,r.jsx)(n.pre,{children:(0,r.jsx)(n.code,{className:"language-sh",children:"adguard-cli config set outbound_proxy false\n"})}),"\n",(0,r.jsx)(n.p,{children:"Or quickly clear the settings:"}),"\n",(0,r.jsx)(n.pre,{children:(0,r.jsx)(n.code,{className:"language-sh",children:'adguard-cli config set outbound_proxy ""\n'})}),"\n",(0,r.jsx)(n.h3,{id:"2-configure-individual-parameters",children:"2. Configure individual parameters"}),"\n",(0,r.jsx)(n.p,{children:"The ability to adjust specific parameters is also available:"}),"\n",(0,r.jsx)(n.pre,{children:(0,r.jsx)(n.code,{className:"language-sh",children:"adguard-cli config set outbound_proxy.enabled true\nadguard-cli config set outbound_proxy.host localhost\nadguard-cli config set outbound_proxy.port 3128\nadguard-cli config set outbound_proxy.username user\nadguard-cli config set outbound_proxy.password pass\n"})}),"\n",(0,r.jsx)(n.p,{children:"Disable certificate verification for HTTPS proxies:"}),"\n",(0,r.jsx)(n.pre,{children:(0,r.jsx)(n.code,{className:"language-sh",children:"adguard-cli config set outbound_proxy.trust_any_certificate true\n"})}),"\n",(0,r.jsx)(n.p,{children:"Enable SOCKS5 proxy for UDP traffic:"}),"\n",(0,r.jsx)(n.pre,{children:(0,r.jsx)(n.code,{className:"language-sh",children:"adguard-cli config set outbound_proxy.udp_through_socks5_enabled true\n"})}),"\n",(0,r.jsx)(n.admonition,{type:"note",children:(0,r.jsx)(n.p,{children:"If your SOCKS5 proxy does not support UDP, connections may fail."})}),"\n",(0,r.jsx)(n.h2,{id:"per-app-adguard-cli-configuration",children:"Per-app AdGuard CLI configuration"}),"\n",(0,r.jsxs)(n.p,{children:["Users often need to enable filtering manually for certain browsers. AdGuard for Linux supp
1orts ",(0,r.jsx)(n.strong,{children:"per-app configuration"}),", allowing you to apply settings or rules individually to each application instead of system-wide."]}),"\n",(0,r.jsxs)(n.p,{children:["For details, refer to the ",(0,r.jsx)(n.code,{children:"apps"})," section in ",(0,r.jsx)(n.code,{children:"proxy.yaml"}),"."]}),"\n",(0,r.jsxs)(n.p,{children:["A set of pre-configured entries for popular web browsers is included by default in ",(0,r.jsx)(n.code,{children:"browsers.yaml"}),"."]}),"\n",(0,r.jsx)(n.h3,{id:"checking-the-current-configuration",children:"Checking the current configuration"}),"\n",(0,r.jsxs)(n.p,{children:["To view the current ",(0,r.jsx)(n.code,{children:"outbound_proxy"})," configuration, enter:"]}),"\n",(0,r.jsx)(n.pre,{children:(0,r.jsx)(n.code,{className:"language-sh",children:"adguard-cli config show outbound_proxy\n"})}),"\n",(0,r.jsx)(n.admonition,{title:"Compatibility",type:"info",children:(0,r.jsxs)(n.p,{children:["Configuring ",(0,r.jsx)(n.code,{children:"outbound_proxy"})," via URL is available starting from AdGuard for Linux v1.1.26 nightly and v1.1 stable release."]})}),"\n",(0,r.jsx)(n.h2,{id:"export-and-import-settings",children:"Export and import settings"}),"\n",(0,r.jsx)(n.p,{children:"The export/import functionality allows you to backup your AdGuard CLI configuration and restore it on the same or different system. This includes filters, proxy settings, and other configuration options."}),"\n",(0,r.jsx)(n.h3,{id:"export-settings",children:"Export settings"}),"\n",(0,r.jsx)(n.p,{children:"To export current AdGuard CLI settings to a ZIP archive, use:"}),"\n",(0,r.jsx)(n.pre,{children:(0,r.jsx)(n.code,{className:"language-sh",children:"adguard-cli export-settings\n"})}),"\n",(0,r.jsxs)(n.p,{children:["You can specify the output path using the ",(0,r.jsx)(n.code,{children:"-o"})," or ",(0,r.jsx)(n.code,{children:"--output"})," flag. This can be either a specific file path or a directory:"]}),"\n",(0,r.jsx)(n.pre,{children:(0,r.jsx)(n.code,{className:"language-sh",children:'# Export to a specific file\nadguard-cli export-settings -o "/path/to/settings.zip"\n\n# Export to a directory (archive will be created with a standard name)\nadguard-cli export-settings -o "/path/to/directory"\n'})}),"\n",(0,r.jsx)(n.p,{children:"If no output path is specified, the settings will be exported to the working directory with a standard name. After successful export, the command will display the full path where the archive was created."}),"\n",(0,r.jsx)(n.h3,{id:"import-settings",children:"Import settings"}),"\n",(0,r.jsx)(n.p,{children:"To import AdGuard CLI settings from a ZIP archive, use:"}),"\n",(0,r.jsx)(n.pre,{children:(0,r.jsx)(n.code,{className:"language-sh",children:'adguard-cli import-settings -i "/path/to/settings.zip"\n'})}),"\n",(0,r.jsxs)(n.p,{children:["The ",(0,r.jsx)(n.code,{children:"-i"})," or ",(0,r.jsx)(n.code,{children:"--input"})," flag is required and specifies the path to the settings archive to import."]}),"\n",(0,r.jsx)(n.h2,{id:"adguard-browser-assistant",children:"AdGuard Browser Assistant"}),"\n",(0,r.jsx)(n.p,{children:"AdGuard Browser Assistant allows you to manage AdGuard protection directly from your browser."}),"\n",(0,r.jsx)(n.p,{children:(0,r.jsx)(n.img,{src:"https://cdn.adtidy.org/content/kb/ad_blocker/mac/assistant_window.png",alt:"The Assistant window *mobile"})}),"\n",(0,r.jsx)(n.h3,{id:"how-it-works",children:"How it works"}),"\n",(0,r.jsx)(n.p,{children:"AdGuard Browser Assistant is a browser extension. It allows you to quickly manage AdGuard for Linux:"}),"\n",(0,r.jsxs)(n.ul,{children:["\n",(0,r.jsx)(n.li,{children:"Enable or disable protection for a specific website (the toggle under the website name)"}),"\n",(0,r.jsx)(n.li,{children:"Pause protection for 30 seconds"}),"\n",(0,r.jsx)(n.li,{children:"Disable protection (the pause icon in the upper right corner)"}),"\n",(0,r.jsx)(n.li,{children:"Manually block an ad"}),"\n",(0,r.jsx)(n.li,{children:"Report incorrect blocking"}),"\n",(0,r.jsx)(n.li,{children:"Manage HTTPS filtering (the lock icon next to the website name)"}),"\n"]}),"\n",(0,r.jsx)(n.h3,{id:"how-to-install",children:"How to install"}),"\n",(0,r.jsx)(n.p,{children:"To install Native Messaging manifests for browser integration, use:"}),"\n",(0,r.jsx)(n.pre,{children:(0,r.jsx)(n.code,{className:"language-sh",children:"adguard-cli install-browser-integration\n"})}),"\n",(0,r.jsx)(n.p,{children:"To uninstall the manifests, use:"}),"\n",(0,r.jsx)(n.pre,{children:(0,r.jsx)(n.code,{className:"language-sh",children:"adguard-cli install-browser-integration --uninstall\n"})}),"\n",(0,r.jsxs)(n.p,{children:[(0,r.jsx)(n.strong,{children:"Install AdGuard Browser Assistant extension"}),":"]}),"\n",(0,r.jsxs)(n.ol,{children:["\n",(0,r.jsxs)(n.li,{children:["Open the ",(0,r.jsx)(n.a,{href:"https://adguard.com/adguard-assistant/overview.html",children:"Assistant page"}),"."]}),"\n",(0,r.jsxs)(n.li,{children:["Under your browser name, select ",(0,r.jsx)(n.em,{children:"Install"}),"."]}),"\n",(0,r.jsx)(n.li,{children:"Install Assistant from your browser\u2019s extension store."}),"\n"]}),"\n",(0,r.jsx)(n.admonition,{title:"Compatibility",type:"info",children:(0,r.jsx)(n.p,{children:"Support for AdGuard Browser Assistant is available starting from AdGuard for Linux v1.4."})})]})}function h(e={}){let{wrapper:n}={...(0,t.R)(),...e.components};return n?(0,r.jsx)(n,{...e,children:(0,r.jsx)(c,{...e})}):c(e)}},91704(e,n,i){i.d(n,{R:()=>d,x:()=>l});var s=i(30758);let r={},t=s.createContext(r);function d(e){let n=s.useContext(t);return s.useMemo(function(){return"function"==typeof e?e(n):{...n,...e}},[n,e])}function l(e){let n;return n=e.disableParentContext?"function"==typeof e.components?e.components(r):e.components||r:d(e.components),s.createElement(t.Provider,{value:n},e.children)}}}]);
Line numbers count LF bytes from the start of the resource, as the search results do. Vendor segments are library code the classifier recognised; they are stored but not indexed. Bytes are shown as Latin1 characters, one per byte.