diff --git a/docs/adguard-for-windows/adguard-for-windows.md b/docs/adguard-for-windows/adguard-for-windows.md index 0ce724cb401..9653f5f24eb 100644 --- a/docs/adguard-for-windows/adguard-for-windows.md +++ b/docs/adguard-for-windows/adguard-for-windows.md @@ -14,7 +14,7 @@ AdGuard for Windows is an easy-to-use tool that blocks annoying banners, popups, --- -![Home screen](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/main_screen.png) +![Home screen *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/main_screen.png) On the Home screen, you’ll find a toggle to enable or disable AdGuard protection, as well as icons for *Ad blocking*, *Tracking protection*, *DNS protection*, and *Annoyance blocking*. Main settings can be accessed through the left-side menu. @@ -36,4 +36,4 @@ Options to select language and theme, view legal documents, check license inform Click *Check for updates* to see whether your app version, filters, and extensions are up to date. -![Check for updates](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/checking_for_updates.png) +![Check for updates *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/checking_for_updates.png) diff --git a/docs/adguard-for-windows/app-management/app-management.md b/docs/adguard-for-windows/app-management/app-management.md index 386a898ccad..41b638ee1dc 100644 --- a/docs/adguard-for-windows/app-management/app-management.md +++ b/docs/adguard-for-windows/app-management/app-management.md @@ -15,7 +15,7 @@ When routing and filtering are enabled for an app, the icons below each app will You can leave the settings as they are, disable both filtering and routing, or fine-tune them manually for each app. You can also access the app’s stats. -![App stats](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/app_management/stats_app.png) +![App stats *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/app_management/stats_app.png) ## How app filtering and routing work in AdGuard for Windows v8.0 diff --git a/docs/adguard-for-windows/protection/ad-blocking.md b/docs/adguard-for-windows/protection/ad-blocking.md index 2d20c9798fb..6580f94ae66 100644 --- a/docs/adguard-for-windows/protection/ad-blocking.md +++ b/docs/adguard-for-windows/protection/ad-blocking.md @@ -5,7 +5,7 @@ sidebar_position: 1 The *Ad blocking* section is responsible for removing ads from the websites you visit and from the apps installed on your device. To filter banners, popups, trackers, and other intrusive elements, AdGuard relies on filters — sets of rules written in a [special syntax](/general/ad-filtering/create-own-filters). If you’d like to learn more about how they work, read our [article about filters](/general/ad-filtering/how-ad-blocking-works). -![Ad blocking](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/ad_blocking.png) +![Ad blocking *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/ad_blocking.png) Here you can: diff --git a/docs/adguard-for-windows/protection/annoyance-blocking.md b/docs/adguard-for-windows/protection/annoyance-blocking.md index 65521025ea5..935dc0ddb7e 100644 --- a/docs/adguard-for-windows/protection/annoyance-blocking.md +++ b/docs/adguard-for-windows/protection/annoyance-blocking.md @@ -7,7 +7,7 @@ Annoyance filters are designed to improve website usability by blocking non-adve These filters may contain rules that are not suitable for all users. Sometimes it is recommended to disable them. The decisions to add rules to this filter are made by filter developers on a rule-by-rule basis. -![Annoyance filters](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/annoyance_blocking.png) +![Annoyance filters *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/annoyance_blocking.png) **Block cookie notices** removes cookie consent banners on webpages. diff --git a/docs/adguard-for-windows/protection/browsing-security.md b/docs/adguard-for-windows/protection/browsing-security.md index 293ba5861bc..76ee1bbb97b 100644 --- a/docs/adguard-for-windows/protection/browsing-security.md +++ b/docs/adguard-for-windows/protection/browsing-security.md @@ -11,7 +11,7 @@ It won’t stop a virus that is already being downloaded, and it won’t remove For more details about how this protection works, see our article [Phishing and malware protection](/general/browsing-security). -![Browsing security](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/browsing.png) +![Browsing security *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/browsing.png) In the *Browsing security* section, you can: diff --git a/docs/adguard-for-windows/protection/dns-protection.md b/docs/adguard-for-windows/protection/dns-protection.md index 506f1d167a7..6f95239c184 100644 --- a/docs/adguard-for-windows/protection/dns-protection.md +++ b/docs/adguard-for-windows/protection/dns-protection.md @@ -17,13 +17,13 @@ Modern protocols like DNS-over-TLS and DNS-over-HTTPS ensure that your DNS reque DNS protection can filter out ads, trackers, phishing websites, and other harmful or annoying content before it even loads in your browser or apps. [Learn more about DNS filtering](https://adguard-dns.io/kb/general/dns-filtering/) -![DNS protection](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/dns.png) +![DNS protection *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/dns.png) Here’s what you can configure in DNS protection: ## Choose a DNS server -![DNS servers](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/dns_server.png) +![DNS servers *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/dns_server.png) You can select from multiple trusted DNS providers. AdGuard itself offers several options for different needs: diff --git a/docs/adguard-for-windows/protection/extensions.md b/docs/adguard-for-windows/protection/extensions.md index bed024c2e8e..f2e94e5df8c 100644 --- a/docs/adguard-for-windows/protection/extensions.md +++ b/docs/adguard-for-windows/protection/extensions.md @@ -5,7 +5,7 @@ sidebar_position: 7 AdGuard can extend website functionality by acting as a [userscript manager](/general/extensions.md). This allows you to add your own scripts as well as manage existing ones. -![Extensions](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/extensions.png) +![Extensions *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/extensions.png) ## Automatically detect userscripts diff --git a/docs/adguard-for-windows/protection/parental-control.md b/docs/adguard-for-windows/protection/parental-control.md index 0928fcf0585..5516ac3dc6d 100644 --- a/docs/adguard-for-windows/protection/parental-control.md +++ b/docs/adguard-for-windows/protection/parental-control.md @@ -5,7 +5,7 @@ sidebar_position: 6 There are several websites that children shouldn’t be able to access. *Parental control* helps you solve this problem. -![Parental control](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/parental.png) +![Parental control *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/parental.png) When *Parental control* is enabled, AdGuard scans the content of webpages and blocks those that may be harmful or inappropriate for children. This includes adult images and text, crude language, violence, and drug-related content. diff --git a/docs/adguard-for-windows/protection/protection.md b/docs/adguard-for-windows/protection/protection.md index ca13e8c11d7..d37775aee4b 100644 --- a/docs/adguard-for-windows/protection/protection.md +++ b/docs/adguard-for-windows/protection/protection.md @@ -3,7 +3,7 @@ title: Protection sidebar_position: 1 --- -![Protection tab](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/protection_section.png) +![Protection tab *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/protection_section.png) The *Protection* tab contains all key security and filtering settings. Here you can control *Ad blocking*, *Tracking protection*, *Annoyance blocking*, *DNS protection*, *Browsing security*, *Parental control*, and *Extensions*. You can also manage AdGuard Assistant here — a tool that lets you control its functionality without opening the app. Each of these features is described in a separate article. diff --git a/docs/adguard-for-windows/protection/tracking-protection.md b/docs/adguard-for-windows/protection/tracking-protection.md index 189681a7295..14e4552e070 100644 --- a/docs/adguard-for-windows/protection/tracking-protection.md +++ b/docs/adguard-for-windows/protection/tracking-protection.md @@ -5,7 +5,7 @@ sidebar_position: 2 Many websites collect data about their visitors, including IP addresses, browser and OS information, screen resolution, and even the page you came from. Cookies can be used to identify your browser, remember your preferences, or recognize you when you return. Tracking protection prevents such systems from collecting your personal data. Learn more in our [article about Tracking protection in AdGuard](https://adguard.com/kb/general/stealth-mode/) -![Tracking protection](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/tracking_protection.png) +![Tracking protection *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/tracking_protection.png) If you don’t want to spend time adjusting filters manually, you can simply pick one of the ready-made protection levels: @@ -27,7 +27,7 @@ For maximum flexibility, select *Custom* and adjust everything manually. The set ## General settings -![General settings](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/custom_general.png) +![General settings *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/custom_general_settings.png) ### Block trackers @@ -37,17 +37,21 @@ Blocks trackers and web analytics using *AdGuard Tracking Protection filter*. Strips tracking parameters such as `utm_*` and `fb_ref` from pages’ URLs using *AdGuard URL Tracking filter*. -### Hide your search queries +### Hide search queries Hides queries for websites visited from a search engine. When you get directed to a website from Google, Yahoo, or any other search engine, this option hides the search query that you used to find that website. -### Ask websites not to track you +### Ask websites not to track me Sends the [Global Privacy Control](https://globalprivacycontrol.org/#gpc-spec) and [Do Not Track](https://en.wikipedia.org/wiki/Do_Not_Track) signals to the websites you visit. +### Other privacy filters + +Applies a set of additional privacy protection filters. The number next to *Enabled in Filters* shows how many filters are currently active. + ## Tracking methods -![Tracking methods](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/custom_tracking_methods.png) +![Tracking methods *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/custom_settings_tracking_methods.png) ### Delete third-party cookies @@ -57,7 +61,7 @@ Third-party cookies work the same way, but they are created by domains other tha With this option, you can set a time limit (in minutes) after which all third-party cookies will be deleted. If you set the timer to 0, such cookies will be blocked completely. -![Time-to-live](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/delete_third_party.png) +![Time-to-live *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/delete_third_party.png) :::caution @@ -89,13 +93,13 @@ The Authorization header value is cached by the browser and automatically sent w ## Browser API -![Browser API](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/custom_browser_api.png) +![Browser API *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/custom_settings_browser_api.png) -### Block WebRTC +### Prevent IP address leaks through WebRTC -Blocks WebRTC, a known vulnerability that can leak your real IP address even if you use a proxy or VPN. +Makes WebRTC use a stricter IP address policy to prevent your real IP address from being exposed, even if you use a proxy or VPN. -WebRTC (Web Real-Time Communication) is a technology that allows direct data streaming between browsers and apps. It can reveal your true IP address, even if you use a proxy or VPN. Enabling this option may disrupt certain browser applications, such as messengers, chats, cinemas, or games. +WebRTC (Web Real-Time Communication) is a technology that allows direct data streaming between browsers and apps. By default, it can reveal your true IP address even when a proxy or VPN is active. This option enforces a stricter IP address policy instead of blocking WebRTC entirely, so browser applications such as messengers, chats, and games are less likely to be affected. ### Block Push API @@ -105,18 +109,18 @@ The Push API allows servers to send messages to web applications regardless of t When this option is enabled, the browser will no longer send GPS data to websites. This prevents them from determining your location, altering search results, or tailoring content based on where you are. -### Block Flash - -The Flash Player plugin is outdated and highly vulnerable to viruses and exploits. It can also slow down website loading. Enabling this option prevents browsers from detecting Flash components (such as plugins or ActiveXObject objects), which effectively disables Flash support. - ## Windows tracking -![Windows tracking](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/custom_windows_tracking.png) +![Windows tracking *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/custom_settings_windows_tracking.png) ### Disable Windows telemetry Disables sending technical data about your system and app usage. +### Disable Windows Recall + +Disables the Windows Recall feature, which periodically takes snapshots of your screen and stores them locally. This prevents sensitive information visible on your screen from being captured and saved. + ### Turn off Advertising ID Disables Advertising ID to block tracking of your app usage. @@ -127,17 +131,17 @@ Blocks automatic reporting and sampling of suspected malware. ### Disable WAP Push message routing service -Disables data collection about Windows component problems +Disables data collection about Windows component problems. ## Miscellaneous -![Miscellaneous](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/custom_misc.png) +![Miscellaneous *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/custom_settings_miscellaneous.png) ### Hide Referer from third parties Referer is an HTTP header included in browser-to-server requests. It contains the URL of the request source. When you navigate from one page to another, Referer saves the URL of the initial page. The server that hosts the destination web page often has software that parses Referer and extracts various pieces of information from it. -Enabling the *Hide Referer from third-parties* option prevents third-party websites from seeing this information by altering or removing the header. +Enabling the *Hide Referer from third parties* option prevents third-party websites from seeing this information by altering or removing the header. You can also enter a custom value in the *Custom Referer* field. To use default Referer, leave the field blank. @@ -145,13 +149,13 @@ Note that to be able to filter traffic, AdGuard applications intercept browser-t Same goes for the *Hide Referer from third parties* option: To filter traffic, AdGuard intercepts HTTP(S) requests and may alter or block them before they reach the server. The change happens only after the request leaves your browser. For this reason, if you check headers inside the browser (for example with Chrome Developer Tools), you will still see the original Referer. To confirm that it has been modified, you can use external tools such as Fiddler. -### Hide your User-Agent +### Hide User-Agent When you visit a website, your browser sends a header called User-Agent as part of the HTTP request. It looks like a text line that begins with “User-Agent:”. This line usually contains details such as the browser name and version, operating system, and language settings. By enabling this option, AdGuard removes identifying information from the User-Agent so advertisers and trackers cannot use it to profile you. If you prefer, you can enter a custom value in the *Custom User-Agent* field. To keep the default value, simply leave the field blank. -### Mask your IP address +### Mask IP address AdGuard cannot completely hide your real IP address, but it can replace it with a different one so that websites interpret your connection as coming through a proxy. In some cases this helps to obscure your true IP. @@ -163,16 +167,29 @@ Prevents Google Chrome from sending information about its version and modificati ### Protect against DPI -The Deep Packet Inspection is a system of deep analysis and filtering of traffic by packet content, as well as the accumulation of statistical data. Using this technology, ISPs have the ability to control the passing traffic and limit access to content for their clients. +![Protect against DPI *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/protect_against_dpi.png) + +Deep Packet Inspection (DPI) is a technology that allows ISPs to analyze and filter traffic based on packet content. With this option enabled, AdGuard modifies outgoing packet data to make it harder for DPI systems to identify and analyze your traffic, helping protect your connection privacy. + +When you click on *Protect against DPI*, a separate screen opens with three groups of settings: + +**ClientHello split** — modifies the TLS ClientHello message to make it harder for DPI systems to detect and block encrypted connections. The following strategies are available: + +- *Split TCP packet at fixed position* — splits the ClientHello TCP packet at a specified byte position. +- *Split TLS record at fixed position* — splits the TLS record containing the ClientHello at a specified byte position. +- *Split TLS before SNI* — splits the ClientHello before the Server Name Indication field. +- *Split TLS after SNI* — splits the ClientHello after the Server Name Indication field. +- *Split TLS in the middle of SNI* — splits the ClientHello in the middle of the Server Name Indication field. +- *Split TLS randomly within SNI* — splits the ClientHello at a random position within the Server Name Indication field. -Deep Packet Inspection (DPI) is a technology used by some ISPs to analyze and filter traffic based on packet content. It allows them to monitor connections, restrict access to certain resources, and collect statistics about users. +When using a fixed-position strategy, set the *Split byte position* (1–1500) to specify where the split occurs. -When this option is enabled, AdGuard modifies outgoing packet data so that it no longer matches the DPI blocking criteria. This can help you bypass restrictions and access the content you need. However, not all DPI systems can be circumvented yet — improvements are still in progress. +**HTTP request split** — splits HTTP requests into multiple TCP packets to bypass DPI systems that rely on inspecting complete HTTP requests. -The *Protect from DPI* feature is already implemented in AdGuard for Windows, AdGuard for Mac, and AdGuard for Android. +**HTTP space juggling** — manipulates whitespace in HTTP requests to confuse DPI systems that parse HTTP headers, making it harder for them to identify and block specific traffic. :::caution -If this feature is enabled in AdGuard for Windows, it may interfere with the ESET antivirus. In this case, ESET will not be able to filter traffic, leaving some malicious or blocked websites accessible. +This feature can break access to some unencrypted websites. If this feature is enabled in AdGuard for Windows, it may also interfere with the ESET antivirus — ESET will not be able to filter traffic, leaving some malicious or blocked websites accessible. ::: diff --git a/docs/adguard-for-windows/settings/about.md b/docs/adguard-for-windows/settings/about.md index bc3cf2077dc..64849b9744b 100644 --- a/docs/adguard-for-windows/settings/about.md +++ b/docs/adguard-for-windows/settings/about.md @@ -3,6 +3,6 @@ title: About sidebar_position: 4 --- -![About](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/settings/about.png) +![About *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/settings/about.png) In addition to information about the current version of the program and used libraries, this screen provides some useful links to License agreement, Privacy policy, acknowledgements, version history, and the main page of our website. diff --git a/docs/adguard-for-windows/settings/app-settings/app-settings.md b/docs/adguard-for-windows/settings/app-settings/app-settings.md index 60612753a77..d8eea48b5db 100644 --- a/docs/adguard-for-windows/settings/app-settings/app-settings.md +++ b/docs/adguard-for-windows/settings/app-settings/app-settings.md @@ -3,13 +3,11 @@ title: App settings sidebar_position: 1 --- -![App settings](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/settings/1_app_settings.png) +![App settings *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/settings/main_settings_1.png) Here you can adjust the main app settings: choose between light and dark themes, set the app language, enable AdGuard to launch at system startup, and allow silent automatic updates. It’s also possible to select the update channel and specify how often AdGuard checks for filter updates. -If you wish, you can agree to send anonymized app usage data to help us improve the product. - -In case of issues, you can change the logging level to create detailed logs for the support team. +You can opt in to send us two types of data: anonymized app usage data to help us improve the product and crash reports if the app unexpectedly closes. In [*Filter editor*](/adguard-for-windows/settings/app-settings/filter-editor.md), you can add your own filtering rules or import ready-to-use filters. @@ -17,4 +15,4 @@ In [*Filter editor*](/adguard-for-windows/settings/app-settings/filter-editor.md [*Advanced*](/adguard-for-windows/settings/app-settings/advanced-settings.md) settings are intended for experienced users. They are rarely needed in everyday use and should only be changed if you know what you’re doing or if our support team asks you to. -![App settings](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/settings/2_app_settings.png) +![App settings *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/settings/main_settings_2.png) diff --git a/docs/adguard-for-windows/settings/app-settings/filter-editor.md b/docs/adguard-for-windows/settings/app-settings/filter-editor.md index 8dbb5a1bbd3..fcabf4215d7 100644 --- a/docs/adguard-for-windows/settings/app-settings/filter-editor.md +++ b/docs/adguard-for-windows/settings/app-settings/filter-editor.md @@ -3,7 +3,7 @@ title: Filter editor sidebar_position: 2 --- -![Filter editor](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/settings/editor.png) +![Filter editor *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/settings/editor.png) The Filter editor is a tool that allows you to view and manage filters at the level of individual rules. Filters are combined into thematic categories: *Ad Blocking*, *Privacy*, *Language-specific* filters, *Custom*, and *Other*. diff --git a/docs/adguard-for-windows/settings/app-settings/network-settings.md b/docs/adguard-for-windows/settings/app-settings/network-settings.md index c2f01d628f5..444cf0ef27b 100644 --- a/docs/adguard-for-windows/settings/app-settings/network-settings.md +++ b/docs/adguard-for-windows/settings/app-settings/network-settings.md @@ -5,7 +5,7 @@ sidebar_position: 3 This section lets you manage how AdGuard filters your Internet traffic and provides additional tools to control network-related features. -![Network settings](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/settings/network_settings.png) +![Network settings *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/settings/network_settings.png) ## Use AdGuard as an HTTP proxy @@ -33,7 +33,7 @@ With this option, you can: Here you can choose which proxy AdGuard should use to download filter updates or new app versions — the system proxy, a custom proxy, or no proxy at all. -![Proxy settings](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/settings/proxy_apps.png) +![Proxy settings *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/settings/proxy_apps.png) ## Use SockFilter driver diff --git a/docs/adguard-for-windows/settings/license.md b/docs/adguard-for-windows/settings/license.md index 821aef7b8a3..01361c14742 100644 --- a/docs/adguard-for-windows/settings/license.md +++ b/docs/adguard-for-windows/settings/license.md @@ -3,7 +3,7 @@ title: License sidebar_position: 2 --- -![License](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/settings/licenses.png) +![License *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/settings/licenses.png) The *License* tab provides details about your current license. Here you can: diff --git a/docs/adguard-for-windows/settings/settings.md b/docs/adguard-for-windows/settings/settings.md index 30a21ac00c1..2b4ebbd4ca7 100644 --- a/docs/adguard-for-windows/settings/settings.md +++ b/docs/adguard-for-windows/settings/settings.md @@ -5,7 +5,7 @@ sidebar_position: 1 There are other useful AdGuard options that shouldn’t go unnoticed in this article, since they add much to user experience. -![Settings](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/settings/setting.png) +![Settings *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/settings/setting.png) ## [App settings](/adguard-for-windows/settings/app-settings) diff --git a/docs/adguard-for-windows/settings/support.md b/docs/adguard-for-windows/settings/support.md index a755413ce40..5de134bfecb 100644 --- a/docs/adguard-for-windows/settings/support.md +++ b/docs/adguard-for-windows/settings/support.md @@ -3,10 +3,14 @@ title: Support sidebar_position: 3 --- -![Support](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/settings/support.png) +![Support *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/settings/support_main_screen.png) -Use this section if you have any questions or suggestions about AdGuard for Windows v8.0. We recommend checking the [FAQ](https://adguard.com/support/faq.html) and this Knowledge base before contacting support. +Use this section if you have any questions or suggestions about AdGuard for Windows. We recommend checking the [FAQ](https://adguard.com/support/faq.html) and this Knowledge base before contacting support. If you notice a missed ad, please let us know using *Report incorrect blocking*. You can also join our social channels to discuss AdGuard with other users, or reach out to us on GitHub to suggest new features or report bugs. + +If you reach out to support and our team asks you for logs or technical data from the app, you can export it here. For step-by-step instructions, see [How to collect AdGuard logs](/adguard-for-windows/solving-problems/adguard-logs). + +![Logs *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/settings/support_logs.png) diff --git a/docs/adguard-for-windows/solving-problems/adguard-logs.md b/docs/adguard-for-windows/solving-problems/adguard-logs.md new file mode 100644 index 00000000000..8d0d65f6918 --- /dev/null +++ b/docs/adguard-for-windows/solving-problems/adguard-logs.md @@ -0,0 +1,103 @@ +--- +title: How to collect AdGuard logs +sidebar_position: 3 +--- + +:::info + +This article covers AdGuard for Windows, a multifunctional ad blocker that protects your device at the system level. To see how it works, [download the AdGuard app](https://agrd.io/download-kb-adblock). + +::: + +:::note + +Data and files provided in logs are processed in accordance with the [AdGuard Privacy Policy](https://adguard.com/en/privacy.html). + +::: + +To diagnose problems you may encounter while using AdGuard, our support team may need AdGuard log files. These files record errors and other events that occur in the application. This article explains how to change the logging level, collect the logs, and send them to support. + +AdGuard for Windows offers two logging levels: *Default* and *Debug*. For most troubleshooting, *Debug* is sufficient, but it may slow down the app. + +## How to change the logging level {#change-level} + +You can change the logging level in either of two ways: + +### Option 1: In the app + +Go to AdGuard settings → *Support* → *Logs*, and in the *Logging level* dropdown select *Debug*. + +![Logging level dropdown on Support page *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/settings/support_logs.png) + +### Option 2: From the tray menu + +Right-click the AdGuard icon in the system tray, select *Advanced* → *Logging level*, and choose *Debug*. + +![Logging level in tray menu *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/solving_problems/tray_menu_debug.png) + +## Debug logs {#debug-logs} + +For most issues, debug logs give the support team enough information to identify and fix the problem. + +1. Set the logging level to *Debug* using one of the methods described [above](#change-level). + +1. Reproduce the issue. Note the exact time — it will help our support team find the relevant log entries and solve the problem faster. + +1. Go to AdGuard settings → *Support* → *Logs*, and click *Export logs and system info*. + + Once the export is complete, you’ll see a confirmation message. You can click *Show in folder* to open the folder where the exported archive with logs and system information was saved. + + :::note + + Set the logging level back to *Default* after exporting the logs. The *Debug* level slows down the application. + + ::: + +1. Send the archive to **support@adguard.com**, describe the problem, and mention the time you reproduced the issue. + +## Trace logs {#trace-logs} + +Sometimes the support team may ask you for *trace* logs. Trace logging captures more detail than debug logging and is only available via command line. + +1. Exit AdGuard by right-clicking the AdGuard icon in the tray menu and choosing *Exit AdGuard*. + + ![Exit AdGuard *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/solving_problems/exit_adguard.png) + + If prompted to keep the service running in the background, make sure to stop it — the service must not be running when you start AdGuard with trace logging. + +1. Open the command prompt (type `cmd` in the Start menu search). + +1. Run AdGuard with trace logging enabled: + + ```text + C:\"Program Files"\Adguard\Adguard.exe /trace + ``` + +1. Reproduce the issue. Note the exact time — it will help our support team find the relevant log entries and solve the problem faster. + +1. Export the collected logs: go to Settings → *Support* → *Logs* → *Export logs and system info*. + + Don’t worry if the log file is large — we need as much detail as possible to fix your problem. + +1. After exporting the trace logs, close AdGuard and restart it normally to return to the default logging level. + +## Diagnostic report {#diagnostic-report} + +When contacting support through the form in Settings → *Support*, you can include a diagnostic report that automatically attaches application logs together with other system information. + +The diagnostic report includes: + +- Information about the system +- A list of running processes +- Details about AdGuard settings, including enabled filters and installed extensions +- Application logs + +To use this option, check the *Add diagnostic report* checkbox before sending your message. + +![Diagnostic report option *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/solving_problems/add_report.png) + +:::note + +AdGuard is committed to protecting your privacy. We strictly follow our [Privacy Policy](https://adguard.com/privacy/windows.html) and do not collect any private information about users. Before sending your logs to the support team, please review the file as it may contain additional information that you don’t want to share. If it contains such personal information, we recommend that you delete it first. + +::: diff --git a/docs/adguard-for-windows/solving-problems/dump-file.md b/docs/adguard-for-windows/solving-problems/dump-file.md index cd46d5d9e5d..954cd504324 100644 --- a/docs/adguard-for-windows/solving-problems/dump-file.md +++ b/docs/adguard-for-windows/solving-problems/dump-file.md @@ -38,8 +38,7 @@ AdGuard for Windows runs two processes: `Adguard.exe` and `AdguardSvc.exe`. You ![Two processes *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/dump_file/new/two_processes_en.png) -Since dump files can be large, please compress them into an archive before sending them to support. Also, include the AdGuard logs to help us diagnose the issue more effectively. -[Instructions for collecting logs](/archive/adguard-for-windows/solving-problems/adguard-logs). +Since dump files can be large, please compress them into an archive before sending them to support. Also, include the AdGuard logs to help us diagnose the issue more effectively. See [Instructions for collecting logs](/adguard-for-windows/solving-problems/adguard-logs). ## Collecting `wfpdiag.cab` file @@ -62,3 +61,5 @@ Our support team may request a wfpdiag.cab file, along with a minidump file, to 1. Visit any website to route traffic through AdGuard and log the filtering process 1. To stop logging, enter `netsh wfp capture stop` + +1. Compress the `wfpdiag.cab` file and send it to our support team at **support@adguard.com**. diff --git a/docs/adguard-for-windows/solving-problems/minidump.md b/docs/adguard-for-windows/solving-problems/minidump.md index cafcbdf3425..6c5f22db8df 100644 --- a/docs/adguard-for-windows/solving-problems/minidump.md +++ b/docs/adguard-for-windows/solving-problems/minidump.md @@ -21,7 +21,7 @@ Blue Screen of Death (BSOD) errors may occasionally occur while using AdGuard. W To collect minidump files, you’ll need administrator access on your computer. By default, Windows stores these files in the `C:\Windows\Minidump\` folder. The files you’re looking for will be named either `MEMORY.DMP` or follow the pattern `Mini(ddmmmyy-xxx).dmp` where the letters and numbers represent dates and sequence numbers. -![Minidump file](https://cdn.adtidy.org/content/kb/ad_blocker/windows/solving-problems/minidump.png) +![Minidump file *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/solving-problems/minidump.png) If you can’t find these files, your system may not be configured to create minidumps automatically. diff --git a/docs/adguard-for-windows/solving-problems/network-dump.md b/docs/adguard-for-windows/solving-problems/network-dump.md index e7084efb3e3..45626e71e3a 100644 --- a/docs/adguard-for-windows/solving-problems/network-dump.md +++ b/docs/adguard-for-windows/solving-problems/network-dump.md @@ -31,7 +31,7 @@ Open Wireshark, and you will see a list of network interfaces. Select the one yo If you’re not sure which interface to choose, pick the one with the most activity in the graph — the higher the graph, the more traffic goes through it. -![Main screen](https://cdn.adtidy.org/content/kb/ad_blocker/windows/solving-problems/main_screen.png) +![Main screen *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/solving-problems/main_screen.png) Double-click the selected interface to start the capture. Now, reproduce the issue you are experiencing, making sure to perform only the necessary actions to trigger the problem and avoid any other processes. This helps isolate the issue and ensures relevant traffic is recorded. diff --git a/docs/adguard-for-windows/statistics/statistics.md b/docs/adguard-for-windows/statistics/statistics.md index 096e63631d1..0a8ef306fc2 100644 --- a/docs/adguard-for-windows/statistics/statistics.md +++ b/docs/adguard-for-windows/statistics/statistics.md @@ -5,7 +5,7 @@ sidebar_position: 1 In *Statistics*, you see a complete picture of what is happening with the traffic on your computer: how many requests are being sent and to which companies, how much data is being uploaded and downloaded, what requests are being blocked. You can check statistics for various time frames: all time, the last 14 days, the last 7 days, the last 24 hours, and broken down by ads, trackers, or requests. -![Customize stats](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/statistics/stats.png) +![Customize stats *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/statistics/stats.png) :::note