From 20575d71fb53429817e5baa81d33ec11f6a41fbe Mon Sep 17 00:00:00 2001 From: ".ext" <279833035+dotext@users.noreply.github.com> Date: Mon, 28 Sep 2026 07:11:18 +1000 Subject: [PATCH 1/2] Update rewards.md --- docs/miscellaneous/contribute/translate/rewards.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/miscellaneous/contribute/translate/rewards.md b/docs/miscellaneous/contribute/translate/rewards.md index df79064955c..80c212e704b 100644 --- a/docs/miscellaneous/contribute/translate/rewards.md +++ b/docs/miscellaneous/contribute/translate/rewards.md @@ -58,6 +58,6 @@ Please note that proofreaders do not receive extra licenses or benefits beyond h ## Gifts for active contributors -To the best contributors, every year we send gifts with the AdGuard merch and give a shout out on our [blog](https://adguard.com/en/blog/best-contributors-2024.html). +To the best contributors, every year we send gifts with the AdGuard merch and give a shout out on our [blog](https://adguard.com/en/blog/best-contributors-2025.html). ![AdGuard merch *border](https://cdn.adguard.com/public/Adguard/Blog/presents.png) From ff7134e883ccc8d57389561fd1b8776ac25699ea Mon Sep 17 00:00:00 2001 From: ".ext" Date: Thu, 8 Oct 2026 09:33:31 +1100 Subject: [PATCH 2/2] Revert "Merge branch 'master' into patch-1" This reverts commit fb7c1980e850d5ee47e1459ce0be42fa542062bc, reversing changes made to 20575d71fb53429817e5baa81d33ec11f6a41fbe. --- .github/workflows/build-deploy.yml | 4 +- .github/workflows/markdown-lint.yml | 1 - .../solving-problems/switch-back-to-v7.md | 46 ---------- .../adguard-mini-for-mac/features/features.md | 4 - .../features/full-version.md | 2 +- .../features/system-wide-protection.md | 92 ------------------- .../solving-problems/exporting-settings.md | 28 ++++++ 7 files changed, 32 insertions(+), 145 deletions(-) delete mode 100644 docs/adguard-for-windows/solving-problems/switch-back-to-v7.md delete mode 100644 docs/adguard-mini-for-mac/features/system-wide-protection.md create mode 100644 docs/archive/adguard-for-windows/solving-problems/exporting-settings.md diff --git a/.github/workflows/build-deploy.yml b/.github/workflows/build-deploy.yml index f0eff1ace78..f7122dd1e0a 100644 --- a/.github/workflows/build-deploy.yml +++ b/.github/workflows/build-deploy.yml @@ -7,7 +7,9 @@ env: on: push: - branches: [master] + branches: ["**"] + tags: + - v* pull_request: types: [opened, reopened, synchronize] workflow_dispatch: diff --git a/.github/workflows/markdown-lint.yml b/.github/workflows/markdown-lint.yml index fbd7447195c..d6b2f8fd7fc 100644 --- a/.github/workflows/markdown-lint.yml +++ b/.github/workflows/markdown-lint.yml @@ -2,7 +2,6 @@ name: Lint Markdown on: push: - branches: [master] pull_request: types: [opened, reopened, synchronize] diff --git a/docs/adguard-for-windows/solving-problems/switch-back-to-v7.md b/docs/adguard-for-windows/solving-problems/switch-back-to-v7.md deleted file mode 100644 index 5bac6878348..00000000000 --- a/docs/adguard-for-windows/solving-problems/switch-back-to-v7.md +++ /dev/null @@ -1,46 +0,0 @@ ---- -title: How to switch back to v7 after updating to v8.0 -sidebar_position: 14 ---- - -:::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) - -::: - -## How to switch back to v7 after updating to v8.0 - -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. - -:::note - -If you wish to preserve your settings, it’s recommended that you export them before changing versions. You can then import your saved settings after updating the app. The steps needed to do so are listed below. - -::: - -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-mini-for-mac/features/features.md b/docs/adguard-mini-for-mac/features/features.md index 8505f6388be..04523e40724 100644 --- a/docs/adguard-mini-for-mac/features/features.md +++ b/docs/adguard-mini-for-mac/features/features.md @@ -31,10 +31,6 @@ sidebar_position: 1 A handy menu in the Safari toolbar -- [System-wide protection](/adguard-mini-for-mac/features/system-wide-protection.md) - - A feature that blocks ads and trackers not just in Safari, but across other apps on your Mac. - - [Full version](/adguard-mini-for-mac/features/full-version.md) Advanced features that enhance filtering speed and power diff --git a/docs/adguard-mini-for-mac/features/full-version.md b/docs/adguard-mini-for-mac/features/full-version.md index 2d0c3442c24..4201b9d8a37 100644 --- a/docs/adguard-mini-for-mac/features/full-version.md +++ b/docs/adguard-mini-for-mac/features/full-version.md @@ -1,6 +1,6 @@ --- title: Full version -sidebar_position: 10 +sidebar_position: 9 --- AdGuard Mini for Mac’s full version unlocks advanced features that provide extra filtering speed and power. diff --git a/docs/adguard-mini-for-mac/features/system-wide-protection.md b/docs/adguard-mini-for-mac/features/system-wide-protection.md deleted file mode 100644 index 5cc6180dbf6..00000000000 --- a/docs/adguard-mini-for-mac/features/system-wide-protection.md +++ /dev/null @@ -1,92 +0,0 @@ ---- -title: System-wide protection -sidebar_position: 9 ---- -Starting with version 3.0, AdGuard Mini for Mac introduces *System-wide protection*, a feature that blocks ads and trackers not just in Safari, but across other apps on your Mac. - -The feature is available for users with an AdGuard license. You can [purchase the license right away](https://adguard.com/license.html) or click *Try for free* in *Advanced protection* to start a 14-day free trial. - -## How it works - -*System-wide protection* is built on Apple’s [**URL filter**](https://developer.apple.com/documentation/networkextension/filtering-traffic-by-url), a system filtering API used for system-wide traffic filtering. Here’s how it works. - -First, macOS checks a URL against a bloom filter — a prefilter stored on your Mac that updates in the background. Most addresses are cleared locally, with no network request for the check itself. - -If the prefilter finds a possible match, macOS asks AdGuard’s server for a verdict using Private Information Retrieval (PIR). This method lets your Mac request data from the server without revealing which exact address it asked about. The request can’t be linked to your account or device. If the server doesn’t respond, the page loads normally. - -You can read [a detailed analysis of Apple’s approach to system-wide filtering](https://adguard.com/en/blog/apple-url-filter-system-wide-filtering-api.html) in our blog. - -## How to turn on System-wide protection - -You’ll find *System-wide protection* under *Advanced protection* in the AdGuard Mini app. To enable it, toggle the switch on. - -![System-wide protection](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/system-wide-protection.png) - -When you first enable *System-wide protection*, you’ll get a request to install the URL filter on your computer. Click *Install*, after which a system message will appear requesting to add filter configurations. This is standard macOS behavior. AdGuard does not see or store any of this data. - -![System-wide protection requires a URL filter](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/install-screen.png) - -After you install the URL filter, *System-wide protection* will remain on by default. If you want it off, toggle off the *System-wide protection* switch in *Advanced protection*. - -You can also click the context menu in the top right corner (⋮) and select *Remove URL Filter*. If you want to reset the filter without deleting it to troubleshoot connection issues, choose *Reset Cache*. - -It’s also possible to disable the URL filter in your Mac’s *System Settings* → *Network* → *VPN & Filters* → *Filters & Proxies*. Change *Enabled* to *Disabled* in the *Status menu*. AdGuard Mini will then switch off *System-wide protection* automatically. - -## Protection levels - -There are three levels of protection you can choose from. *Essential* is selected by default. - -- *Essential* — blocks ads and trackers -- *Safe* — blocks ads, trackers, phishing, and malware -- *Family* — blocks ads, trackers, phishing, malware, and adult content - -![Three levels of protection](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/levels-of-protection.png) - -## Troubleshooting - -### System-wide protection doesn’t work with every app or browser - -Coverage depends on how each app handles network requests, so some apps may not be filtered. This is a limitation on Apple’s side. - -Chromium-based browsers, such as Chrome, Edge, Opera, and Brave, use their own networking code instead of Apple’s frameworks, so the URL filter can’t check their requests. - -### System-wide protection doesn’t turn on - -- **Your Mac runs an older version of macOS.** Apple’s URL filter needs macOS 26 Tahoe or later. On earlier versions, the setting is disabled and the app asks you to *Update to macOS Tahoe 26 or later*. -- **Your account isn’t supported.** *System-wide protection* only works with the first user account created on a Mac. If your account was added later, the setting is disabled and shows *Not supported on this Mac account*. See [Can I change my Mac account’s user ID?](/adguard-mini-for-mac/features/system-wide-protection/#can-i-change-my-mac-accounts-user-id) below. -- **You’re on the free version.** To use *System-wide protection*, [purchase an AdGuard license](https://adguard.com/license.html) or click *Try for free* in *Advanced protection* to start a 14-day free trial. - -### Can I change my Mac account’s user ID? - -Yes. *System-wide protection* only works with the first user account created on a Mac with the user ID (UID) of 501. If your Mac has more than one account, or if you migrated your account from an older Mac, your UID might be different. Follow the steps below to check your UID and, if needed, free up 501 and assign it to your account. - -:::warning - -This is an advanced, risky operation. Only do this if you have no other option. Freeing up UID 501 means deleting an existing account and creating a new one from Terminal. If something goes wrong, this can cause permanent data loss. Back up all the data on your Mac before proceeding. - -::: - -1. **Check your current UID.** Open Terminal, type `id -u`, and press Return. If the result is 501, your account already has the right UID. You don’t need to do anything else. - -2. **Find out who has UID 501.** If your UID is not 501, run this command: - - ```bash - dscacheutil -q user -a uid 501 | grep -E '^(name|uid|gecos):' - ``` - - This shows the username, UID, and full name of that account. Make sure you don’t need any files from it, or back them up before continuing. - -3. **Delete the account with UID 501.** While logged in to your own admin account, open *System Settings* → *Users & Groups*, select the account from step 2, and delete it. When macOS asks what to do with its home folder, choose *Save the home folder in a disk image* — this keeps the account’s files in case you need them later. -4. **Create a new account with UID 501.** Run the following command, replacing `username` and `Name Surname` with the details you want: - - ```bash - sudo sysadminctl -addUser username \ - -fullName "Name Surname" \ - -password - \ - -admin \ - -UID 501 - ``` - - `-password -` makes Terminal prompt you for the password interactively; `-admin` gives the new account administrator rights. - -5. **Verify the change.** Log in to the new account, then check the UID again: open Terminal, type `id -u`, and press Return. The result should now be 501. diff --git a/docs/archive/adguard-for-windows/solving-problems/exporting-settings.md b/docs/archive/adguard-for-windows/solving-problems/exporting-settings.md new file mode 100644 index 00000000000..fa23e2b3b7f --- /dev/null +++ b/docs/archive/adguard-for-windows/solving-problems/exporting-settings.md @@ -0,0 +1,28 @@ +--- +title: How to switch back to the previous version after updating to v8.0 +sidebar_position: 12 +--- + +:::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) + +::: + +The changes in AdGuard for Windows v8.0 are significant, and we hope you love the new version. However, chances are something won’t go the way you expected. Version 8.0 is very different; after all, it’s the first nightly. If you find the v8.0 interface uncomfortable or have encountered too many functionality/stability issues, you can restore the previous version along with its settings. + +To ensure your settings are preserved during the whole process, it’s recommended to export them before upgrading to v8.0. If needed, you can then reinstall the version 7 and import back your saved settings. + +As an alternative, the following method is also available: + +1. After upgrading to version 8, open the folder `C:\ProgramData\Adguard\Backups` and find a ZIP file with a name similar to `adguard_settings_7.21.5008.0-08-04-2025-13_42_15.276.zip`. +2. Copy this ZIP file somewhere outside of `C:\ProgramData\Adguard`, for example, to the desktop. This is important because it will be deleted in the next step. +3. Uninstall version 8.0 with the **setting removal** option on. +4. Install the previous build. You can find the download link in the *Assets* section [on GitHub](https://github.com/AdguardTeam/AdguardForWindows/releases/tag/v7.21.0-rc-2). +5. Exit version 7 from the system tray to stop the filtering. +6. Extract the contents of the ZIP file from the first step and replace the following files: + - `adguard.db` → `C:\ProgramData\Adguard` + - `agflm_dns.db` and `agflm_standard.db` → `C:\ProgramData\Adguard\FLM` +7. Launch AdGuard. + +All set!