diff --git a/docs/adguard-for-windows/app-management/_category_.json b/docs/adguard-for-windows/app-management/_category_.json index 5f698b23036..fc5fe33d03d 100644 --- a/docs/adguard-for-windows/app-management/_category_.json +++ b/docs/adguard-for-windows/app-management/_category_.json @@ -1,5 +1,5 @@ { - "position": 4, + "position": 5, "label": "App management", "collapsible": true, "collapsed": true diff --git a/docs/adguard-for-windows/installation.md b/docs/adguard-for-windows/installation.md new file mode 100644 index 00000000000..6b6eb82289f --- /dev/null +++ b/docs/adguard-for-windows/installation.md @@ -0,0 +1,113 @@ +--- +title: Installation +sidebar_position: 2 +--- + +:::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). + +::: + +## System requirements + +- **OS version:** Microsoft Windows 10 or higher +- **RAM:** at least 6 GB +- **Processor:** 2-core, 2.0 GHz (or faster) +- **Free disk space:** at least 4 GB + +## How to install AdGuard + +1. Go to the [AdGuard website](https://adguard.com) and click *Download*. You can also get the installer from the [download page](https://adguard.com/download.html?auto=1) — the download will start automatically. + + ![Download AdGuard *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/installation/installation_new/website_en.png) + +1. Once the download is complete, open the file *adguardInstaller.exe*. + + ![Downloaded file *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/installation/installation_new/download_en.png) + +1. You’ll see a User Account Control prompt asking if you want to allow the app to make changes to your PC. Click *Yes*. + + ![Allow changes *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/windows/installation/allow-changes.png) + +1. Choose the folder where you want AdGuard to be installed and click Save. + + ![Choose folder *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/installation/installation_new/installer1_en.png) + + If you want to select a different location, click *Browse*, choose the folder, and click *OK*. You can also create a new folder by clicking *Make New Folder* and naming it. If you’d like a desktop shortcut, check the box *Create a desktop shortcut*. Then click *Install* to start the installation. + + ![Start installation *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/installation/installation_new/installer2_en.png) + +1. Wait for the installation to complete and click *Finish*. + + ![Complete installation *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/installation/installation_new/installation_completed.png) + + AdGuard has been successfully installed. When you launch the app, you’ll be prompted to accept our privacy documents and set up protection according to your preferences. + + ![Welcome on board *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/installation/installation_new/welcome.png) + + ![Setting up protection *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/installation/installation_new/setup.png) + +## How to uninstall AdGuard for Windows {#uninstall} + +### Regular method + +If you need to uninstall or reinstall AdGuard, do the following: + +Open the *Start Menu*, then select *Settings*. In the window that opens, click *Apps* → *Installed apps*. Select *AdGuard* from the list of your installed apps, click the three-dot menu, and select *Uninstall*. After the app is uninstalled, restart your computer. + +![Uninstallation *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/installation/installation_new/win11_uninstall_adguard.png) + +:::note + +The uninstaller automatically creates a backup of your settings in `C:\ProgramData\Adguard\Backups`. If you plan to reinstall AdGuard later, you can use this backup to restore your settings. For more information, see [How to back up and restore AdGuard settings](/adguard-for-windows/solving-problems/backup-and-restore). + +::: + +### Advanced method {#advanced} + +If the regular uninstall doesn’t work for any reason, you can use the advanced method. First, [download the uninstaller tool](https://static.adtidy.org/windows/uninstaller/uninstall_utility.zip) created by our developers. Extract the archive to any folder on your PC and run **Adguard.UninstallUtility.exe**, then allow the app to make changes to your device. + +1. Select *AdGuard Ad Blocker* and *Standard* uninstall type, then click *Uninstall*. + + ![Standard uninstall *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/installation/installation_new/advanced_uninstall_standard.png) + +1. Wait until the uninstall is finished and restart your computer. + + ![Uninstall finished *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/installation/installation_new/uninstall_complete.png) + +:::caution + +Follow the next steps only if the Standard uninstall didn’t fully remove AdGuard. We strongly suggest contacting our support before using the Extended uninstall. + +::: + +1. Select *AdGuard Ad Blocker* and *Extended*. Click *Yes, continue* in the prompt and then click *Uninstall*. + + ![Extended uninstall warning *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/installation/installation_new/uninstall_extended.png) + +1. Wait until the uninstall is finished and restart your computer. + + ![Restart prompt *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/installation/installation_new/restart_prompt.png) + +AdGuard is successfully uninstalled! + +### Running the uninstaller in console mode + +You can also use command-line arguments to uninstall AdGuard for Windows. + +1. Open Command Prompt by typing `cmd` in the Start menu. +1. Use `/console` to run the uninstaller in console mode, without the interactive UI. All the command-line parameters below will be ignored if the `/console` mode is not activated. +1. Use `/adblocker` to uninstall AdGuard for Windows. It should look like this: + + ```text + Adguard.UninstallUtility.exe /console /adblocker + ``` + +1. You can also use `/advanced` to force the uninstaller to run in *Extended* mode and `/settings` to force the uninstaller to remove user settings along with the application. + +:::note + +The parameters `/console` and `/adblocker` are necessary for a successful uninstall. The parameters `/advanced` and `/settings` are optional. + +::: diff --git a/docs/adguard-for-windows/protection/_category_.json b/docs/adguard-for-windows/protection/_category_.json index bf89b64aaa9..8194a0b7cfd 100644 --- a/docs/adguard-for-windows/protection/_category_.json +++ b/docs/adguard-for-windows/protection/_category_.json @@ -1,5 +1,5 @@ { - "position": 2, + "position": 3, "label": "Protection", "key": "protection-adguard-for-windows-8", "collapsible": true, diff --git a/docs/adguard-for-windows/settings/_category_.json b/docs/adguard-for-windows/settings/_category_.json index b6b5c6361e2..aabc879a1bf 100644 --- a/docs/adguard-for-windows/settings/_category_.json +++ b/docs/adguard-for-windows/settings/_category_.json @@ -1,5 +1,5 @@ { - "position": 5, + "position": 6, "label": "Settings", "key": "settings-adguard-for-windows-8", "collapsible": true, diff --git a/docs/adguard-for-windows/solving-problems/_category_.json b/docs/adguard-for-windows/solving-problems/_category_.json index 32ac90f3386..02261c7cc6a 100644 --- a/docs/adguard-for-windows/solving-problems/_category_.json +++ b/docs/adguard-for-windows/solving-problems/_category_.json @@ -1,5 +1,5 @@ { - "position": 6, + "position": 7, "label": "Solving problems", "key": "solving-problems-adguard-for-windows-8", "collapsible": true, diff --git a/docs/adguard-for-windows/solving-problems/backup-and-restore.md b/docs/adguard-for-windows/solving-problems/backup-and-restore.md new file mode 100644 index 00000000000..78880410ed7 --- /dev/null +++ b/docs/adguard-for-windows/solving-problems/backup-and-restore.md @@ -0,0 +1,75 @@ +--- +title: How to back up and restore AdGuard settings +sidebar_position: 2 +--- + +:::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). + +::: + +When you update or uninstall AdGuard for Windows, the app automatically creates a backup of your settings in `C:\ProgramData\Adguard\Backups` as a ZIP file with a name like `adguard_settings_7.22.5008.0-08-04-2025-13_42_15.276.zip`. You can use this backup to restore your settings after reinstalling AdGuard. + +If AdGuard couldn’t transfer your settings to a new version, it will show a message offering to import the saved backup or keep the default settings. + +![Failed to transfer settings *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/solving_problems/failed_to_transfer_settings.png) + +## How to export and import settings manually {#export-import} + +You don’t have to wait for an automatic backup — you can create a settings file at any time and import it later. In AdGuard for Windows, open *Settings* and go to the *App settings* tab. Click the three-dot menu in the top right corner. + +![Settings *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/solving_problems/settings_export_import.png) + +- **Export settings** — saves your settings (filters, custom rules, DNS configuration, and app preferences) to an `.adg` file. Choose a location and save the file. +- **Import settings** — restores settings from a previously exported `.adg` file. After importing, AdGuard will prompt you to restart the app to apply the changes. + +## How to restore settings after reinstalling AdGuard v8 {#reinstall-v8} + +If you’ve uninstalled AdGuard v8.0 (for example, to fix a corrupted installation) and want to reinstall it with your previous settings: + +1. Before reinstalling, locate the backup ZIP file in `C:\ProgramData\Adguard\Backups`. Copy it to a safe location outside `C:\ProgramData\Adguard`, such as your Desktop — the folder will be cleaned during reinstallation. + +1. Install AdGuard v8.0 again. + +1. Exit AdGuard from the system tray to stop filtering. + +1. Extract the contents of the backup ZIP file. + +1. Replace the following files with the ones from the backup: + + - `adguard.db` → `C:\ProgramData\Adguard` — main settings database, including filters and custom rules + - `agflm_dns.db` → `C:\ProgramData\Adguard\FLM` — DNS filter database + - `agflm_standard.db` → `C:\ProgramData\Adguard\FLM` — standard filter database + +1. Launch AdGuard. Your previous settings, filters, and custom rules will be restored. + +## How to switch back to v7 after updating to v8.0 {#switch-back-v7} + +AdGuard for Windows v8.0 introduces significant changes. If you find the new interface uncomfortable or encounter issues, you can switch back to version 7. + +1. After upgrading to v8, open the folder `C:\ProgramData\Adguard\Backups` and find a ZIP file with a name similar to `adguard_settings_7.22.5008.0-08-04-2025-13_42_15.276.zip`. + +1. Copy this ZIP file somewhere outside `C:\ProgramData\Adguard`, for example, to your Desktop. This is important because the folder will be cleaned during the next step. + +1. Uninstall v8.0 via *Settings* → *Apps* → *Installed apps*. In the uninstaller dialog, check the box to remove all user settings and data so that no v8 leftovers remain. + + ![Uninstall *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/solving_problems/uninstall.png) + + :::note + + For step-by-step instructions, see [How to uninstall AdGuard for Windows](/adguard-for-windows/installation#uninstall). + + ::: + +1. Install the previous version. You can find the download link in the *Assets* section of the latest stable v7 release [on GitHub](https://github.com/AdguardTeam/AdguardForWindows/releases/tag/v7.22.9). + +1. Exit version 7 from the system tray to stop filtering. + +1. Extract the contents of the ZIP file from step 2 and replace the following files: + + - `adguard.db` → `C:\ProgramData\Adguard` — main settings database, including filters and custom rules + - `agflm_dns.db` → `C:\ProgramData\Adguard\FLM` — DNS filter database + - `agflm_standard.db` → `C:\ProgramData\Adguard\FLM` — standard filter database + +1. Launch AdGuard. Version 7 will start with your previous settings restored. diff --git a/docs/adguard-for-windows/statistics/_category_.json b/docs/adguard-for-windows/statistics/_category_.json index e8cc07ffc0a..7dba26fd96a 100644 --- a/docs/adguard-for-windows/statistics/_category_.json +++ b/docs/adguard-for-windows/statistics/_category_.json @@ -1,5 +1,5 @@ { - "position": 3, + "position": 4, "label": "Statistics", "collapsible": true, "collapsed": true