From fd412bdf23303e6f26e5406fcd0089d913154294 Mon Sep 17 00:00:00 2001 From: SeverAnna Date: Wed, 2 Sep 2026 17:48:44 +0300 Subject: [PATCH 1/3] AG-58384: Add backup-and-restore article and update installation guide for AdGuard for Windows v8 --- docs/adguard-for-windows/installation.md | 113 ++++++++++++++++++ .../solving-problems/backup-and-restore.md | 75 ++++++++++++ 2 files changed, 188 insertions(+) create mode 100644 docs/adguard-for-windows/installation.md create mode 100644 docs/adguard-for-windows/solving-problems/backup-and-restore.md diff --git a/docs/adguard-for-windows/installation.md b/docs/adguard-for-windows/installation.md new file mode 100644 index 00000000000..f25f8956cc7 --- /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/solving-problems/backup-and-restore.md b/docs/adguard-for-windows/solving-problems/backup-and-restore.md new file mode 100644 index 00000000000..d750603a9f7 --- /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. From e5d20659497d9c9de7ae96eab58ed6171a7ab20b Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Wed, 2 Sep 2026 14:57:37 +0000 Subject: [PATCH 2/3] Normalize Windows documentation line endings Co-authored-by: SeverAnna <141145497+SeverAnna@users.noreply.github.com> --- docs/adguard-for-windows/installation.md | 226 +++++++++--------- .../solving-problems/backup-and-restore.md | 150 ++++++------ 2 files changed, 188 insertions(+), 188 deletions(-) diff --git a/docs/adguard-for-windows/installation.md b/docs/adguard-for-windows/installation.md index f25f8956cc7..6b6eb82289f 100644 --- a/docs/adguard-for-windows/installation.md +++ b/docs/adguard-for-windows/installation.md @@ -1,113 +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. - -::: +--- +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/solving-problems/backup-and-restore.md b/docs/adguard-for-windows/solving-problems/backup-and-restore.md index d750603a9f7..78880410ed7 100644 --- a/docs/adguard-for-windows/solving-problems/backup-and-restore.md +++ b/docs/adguard-for-windows/solving-problems/backup-and-restore.md @@ -1,75 +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. +--- +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. From dc798be1447d7d5128ff0af8455f769e0bc9bdf9 Mon Sep 17 00:00:00 2001 From: SeverAnna Date: Wed, 2 Sep 2026 18:02:43 +0300 Subject: [PATCH 3/3] AG-58384: Update sidebar positions for AdGuard for Windows sections --- docs/adguard-for-windows/app-management/_category_.json | 2 +- docs/adguard-for-windows/protection/_category_.json | 2 +- docs/adguard-for-windows/settings/_category_.json | 2 +- docs/adguard-for-windows/solving-problems/_category_.json | 2 +- docs/adguard-for-windows/statistics/_category_.json | 2 +- 5 files changed, 5 insertions(+), 5 deletions(-) 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/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/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