Skip to content

Commit

Permalink
[AGM-1662] Update system-wide-filtering.md
Browse files Browse the repository at this point in the history
Update the article in accrodance with AdGuard for iOS 4.5
  • Loading branch information
vyanovsky authored Jul 20, 2023
1 parent f123b89 commit d61eb40
Showing 1 changed file with 26 additions and 28 deletions.
54 changes: 26 additions & 28 deletions docs/adguard-for-ios/solving-problems/system-wide-filtering.md
Original file line number Diff line number Diff line change
@@ -1,55 +1,53 @@
---
title: How to configure system-wide filtering with AdGuard for iOS
title: How to enable system-wide filtering in AdGuard for iOS
sidebar_position: 2
---

:::info

This article covers AdGuard for iOS, a multifunctional ad blocker that protects your device at the system level. To see how it works, [download the AdGuard app](https://adguard.com/download.html?auto=true)
This article covers AdGuard for iOS, a multifunctional ad blocker that protects your device at the system level. To see how it works firsthand, [download the AdGuard app](https://adguard.com/download.html?auto=true)

:::

## About system-wide filtering

System-wide filtering means blocking ads and trackers beyond the Safari browser, i.e. in other apps and browsers. This article will tell you how to set it up on your iOS device.
System-wide filtering means blocking ads and trackers beyond the Safari browser, i.e. in all other apps and browsers. This article will tell you how to enable it on your iOS device.

On iOS, the only way to block ads and trackers system-wide is to use [DNS filtering](https://adguard-dns.io/kb/general/dns-filtering/). First, you have to enable DNS protection. To do so, open *AdGuard for iOS settings**DNS protection* and switch it on.
On iOS, the only way to block ads and trackers system-wide is to use [DNS filtering](https://adguard-dns.io/kb/general/dns-filtering/).

![DNS protection screen *mobile_border](https://cdn.adtidy.org/public/Adguard/Blog/ios_dns_protection.PNG)

Now, if your purpose is to block ads and trackers system-wide, you have two options:

1. Enable AdGuard DNS server (*Settings**DNS protection**DNS server**AdGuard DNS*).
2. Add a DNS filter/hosts file that will block ad and tracking domains, e.g. AdGuard DNS filter.

The second option takes a bit more time to set up but has several advantages:
First, you have to enable DNS protection. To do so:

* You can use any DNS server at your discretion and you are not tied up to a specific blocking server.
* You can add multiple DNS filters and/or hosts files at the same time, but you can't use multiple DNS servers at once.
1. Open *AdGuard for iOS*.
2. Tap *Protection* 🛡 icon (the second icon in the bottom menu bar).
3. Turn *DNS protection* switch on.

![How DNS filtering works](https://cdn.adtidy.org/public/Adguard/kb/DNS_filtering/how_dns_filtering_works_en.png)
![DNS protection screen *mobile_border](https://cdn.adtidy.org/public/Adguard/Blog/ios_dns_protection.PNG)

## How to add a DNS filter/hosts file
Now, if your purpose is to block ads and trackers system-wide, you have three options:

You can add any DNS filter or hosts file, the instruction will be the same for all of them. For the sake of the example, let's add [AdGuard DNS filter](https://github.com/AdguardTeam/AdguardSDNSFilter). It is composed of several other filters (AdGuard Base filter, Social Media filter, Tracking Protection filter, Mobile Ads filter, EasyList, EasyPrivacy, etc.) and it's simplified specifically to be better compatible with DNS-level ad blocking.
1. Use AdGuard DNS filter (*Protection* 🛡 → *DNS protection**DNS filtering**DNS filters**AdGuard DNS Filter*).
2. Use AdGuard DNS server (*Protection* 🛡 → *DNS protection**DNS server**AdGuard DNS*) or another blocking DNS server to your liking.
3. Add a custom DNS filter/hosts file to your liking.

1. Open *AdGuard for iOS settings**General*.
2. Enable *Advanced mode*. The *Advanced settings* tab will appear. Open it.
The first and third option has several advantages:

![Open AdGuard Settings and enable Advanced mode *mobile_border](https://cdn.adtidy.org/public/Adguard/Release_notes/iOS/v4.0/advanced_mode_en.jpg)
* You can use any DNS server at your discretion and you are not tied up to a specific blocking server, because the filter does the blocking.
* You can add multiple DNS filters and/or hosts files (although using too many might slow down AdGuard).

![Advanced settings screen *mobile_border](https://cdn.adtidy.org/public/Adguard/Blog/ios_advanced_settings.PNG)
![How DNS filtering works](https://cdn.adtidy.org/public/Adguard/kb/DNS_filtering/how_dns_filtering_works_en.png)

:::note
## How to add custom DNS filter/hosts file

We don't recommend touching other settings you'll find inside the *Advanced settings* tab, especially when it comes to *Low-level settings*. Some of them might break the Internet connection or compromise your privacy and security, so it's better to be careful. The text below describes the exact actions required to add AdGuard DNS filter.
You can add any DNS filter or hosts file you like.

:::
For the sake of the example, let's add [OISD Big filter](https://oisd.nl/).

3. Copy this link: `https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_15_DnsFilter/filter.txt` (it's a link for AdGuard DNS filter)
4. Open *AdGuard for iOS settings**DNS protection**DNS filtering* (available while *Advanced mode* is enabled) → *DNS filters*.
5. Tap *Add a filter*, paste the link into the filter URL field, and tap 'Next'.
1. Copy this link: `https://big.oisd.nl` (it's a link for OISD Big filter)
2. Open *Protection* 🛡 → *DNS protection**DNS filtering**DNS filters*.
3. Tap *Add a filter*.
4. Paste the link into the filter URL field.
5. Tap *Next**Add*.

![Adding a DNS filter screen *mobile_border](https://cdn.adtidy.org/public/Adguard/Blog/ios_adding_a_filter.PNG)

Add any number of other DNS filters the same way by pasting a different URL at step 3. You can find various filters and links to them [here](https://filterlists.com).
Add any number of other DNS filters the same way by pasting a different URL at step 4. You can find various filters and links to them [here](https://filterlists.com).

0 comments on commit d61eb40

Please sign in to comment.