Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/adguard-for-windows/app-management/_category_.json
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
{
"position": 4,
"position": 5,
"label": "App management",
"collapsible": true,
"collapsed": true
Expand Down
113 changes: 113 additions & 0 deletions docs/adguard-for-windows/installation.md
Original file line number Diff line number Diff line change
@@ -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.

:::
2 changes: 1 addition & 1 deletion docs/adguard-for-windows/protection/_category_.json
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
{
"position": 2,
"position": 3,
"label": "Protection",
"key": "protection-adguard-for-windows-8",
"collapsible": true,
Expand Down
2 changes: 1 addition & 1 deletion docs/adguard-for-windows/settings/_category_.json
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
{
"position": 5,
"position": 6,
"label": "Settings",
"key": "settings-adguard-for-windows-8",
"collapsible": true,
Expand Down
2 changes: 1 addition & 1 deletion docs/adguard-for-windows/solving-problems/_category_.json
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
{
"position": 6,
"position": 7,
"label": "Solving problems",
"key": "solving-problems-adguard-for-windows-8",
"collapsible": true,
Expand Down
75 changes: 75 additions & 0 deletions docs/adguard-for-windows/solving-problems/backup-and-restore.md
Original file line number Diff line number Diff line change
@@ -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.
2 changes: 1 addition & 1 deletion docs/adguard-for-windows/statistics/_category_.json
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
{
"position": 3,
"position": 4,
"label": "Statistics",
"collapsible": true,
"collapsed": true
Expand Down
Loading