Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[AGM-1944] update AGVPN for iOS section #161

Merged
merged 28 commits into from
Mar 21, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
28 commits
Select commit Hold shift + click to select a range
4c34fa3
[AGM-1944] Update AGVPN for iOS kb section
vyanovsky Mar 5, 2024
e5623dd
Update category_json for solving problems
vyanovsky Mar 5, 2024
220a5c4
Update docs/adguard-vpn-for-ios/installation.md
vyanovsky Mar 14, 2024
f762521
Update docs/adguard-vpn-for-ios/overview.md
vyanovsky Mar 14, 2024
c3729e8
Update docs/adguard-vpn-for-ios/overview.md
vyanovsky Mar 14, 2024
86eb860
Update docs/adguard-vpn-for-ios/overview.md
vyanovsky Mar 14, 2024
9bf5d2f
Update docs/adguard-vpn-for-ios/overview.md
vyanovsky Mar 14, 2024
135b0d9
Update docs/adguard-vpn-for-ios/overview.md
vyanovsky Mar 14, 2024
64deabb
Update docs/adguard-vpn-for-ios/overview.md
vyanovsky Mar 14, 2024
b0ecef2
Update docs/adguard-vpn-for-ios/overview.md
vyanovsky Mar 14, 2024
db9afb6
Update docs/adguard-vpn-for-ios/solving-problems/logs.md
vyanovsky Mar 14, 2024
3c92167
Update docs/adguard-vpn-for-ios/solving-problems/logs.md
vyanovsky Mar 14, 2024
93c14ed
Update docs/adguard-vpn-for-ios/overview.md
vyanovsky Mar 14, 2024
ce08c00
Update docs/adguard-vpn-for-ios/installation.md
vyanovsky Mar 14, 2024
0e47009
Update docs/adguard-vpn-for-ios/overview.md
vyanovsky Mar 14, 2024
374a773
Update docs/adguard-vpn-for-ios/overview.md
vyanovsky Mar 14, 2024
ef0e358
Update docs/adguard-vpn-for-ios/overview.md
vyanovsky Mar 14, 2024
0c69217
Update docs/adguard-vpn-for-ios/overview.md
vyanovsky Mar 14, 2024
7c01e73
Update docs/adguard-vpn-for-ios/overview.md
vyanovsky Mar 14, 2024
6586813
Update docs/adguard-vpn-for-ios/overview.md
vyanovsky Mar 14, 2024
021a70b
Update docs/adguard-vpn-for-ios/overview.md
vyanovsky Mar 14, 2024
7f126c4
Review fixes
vyanovsky Mar 14, 2024
487cc44
Apply suggestions from code review
vyanovsky Mar 14, 2024
490082f
Add two ':::info' blocks to logs.md
vyanovsky Mar 14, 2024
33235f5
fix lint new line
vyanovsky Mar 14, 2024
0d85764
Update docs/adguard-vpn-for-ios/overview.md
vyanovsky Mar 19, 2024
cd2861b
Update docs/adguard-vpn-for-ios/solving-problems/integrated-mode.md
vyanovsky Mar 19, 2024
d64253a
Update docs/adguard-vpn-for-ios/solving-problems/integrated-mode.md
vyanovsky Mar 21, 2024
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
21 changes: 12 additions & 9 deletions docs/adguard-vpn-for-ios/installation.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,32 +5,35 @@ sidebar_position: 2

## System requirements

AdGuard VPN can only be installed on devices with **iOS 11.2 and iPadOS 11.2 or later**.
AdGuard VPN can only be installed on devices with **iOS 14.2 and iPadOS 14.2 or later**.

## How to install AdGuard VPN for iOS

You can download and install the *AdGuard VPN for iOS* app for free in the *App Store*. To do this, follow [this link](https://agrd.io/ios_vpn) and tap on the *Download* icon or follow a few simple steps:
You can download and install the *AdGuard VPN for iOS* app for free in the *App Store*.

1. Open the *App Store* app on your device and tap *Search* in the bottom right corner of the screen.
To do this, [go to App Store](https://agrd.io/ios_vpn) and tap *GET*.

Or you can use App Store’s search to find AdGuard VPN:

1. Open the *App Store* app on your iOS device and tap *Search* 🔍 in the bottom right corner of the screen.

![App Store *mobile_border](https://cdn.adguardvpn.com/content/kb/vpn/ios/app-store-en.png)

1. Next, in the search bar, start typing *"AdGuard"* and select *"adguard vpn"* from the list of suggested options.

![Search *mobile_border](https://cdn.adguardvpn.com/content/kb/vpn/ios/search-en.png)

1. Select *AdGuard VPN - Unlimited & Fast* from the list of suggested apps and tap *Download*. If necessary, enter your Apple ID account password in the opened window.
1. Select *AdGuard VPN - Unlimited & Fast* from the list of suggested apps and tap *GET*. If necessary, enter your Apple ID account password in the opened window.
1. Wait for the download to finish and tap *OPEN* to open the app.

![AdGuard VPN *mobile_border](https://cdn.adguardvpn.com/content/kb/vpn/ios/adguard-vpn-en.png)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

не очень круто что тут Open а не Get, но в целом не критично

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

не оч понял ты о чем

Copy link
Contributor Author

@vyanovsky vyanovsky Mar 14, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

а, типа на скрине

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ну переставил скрин ниже, теперь совсем норм

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

тоже не очень поняла)


1. Wait for the download to finish and tap *Open*.

AdGuard VPN for iOS has been successfully installed!
That’s it! AdGuard VPN for iOS has been successfully installed on your device.

## How to uninstall AdGuard VPN for iOS

If you decided to delete AdGuard VPN for iOS, find the icon of this app on the Home Screen and hold it. In the opened list, tap *Remove App*.
If you have decided to delete AdGuard VPN for iOS, find and hold its icon on the home screen. In the menu that opens, tap *Remove App*.

![Uninstall *mobile_border](https://cdn.adguardvpn.com/public/Adguard/kb/vpn-install/deinstall-en.png)
![Uninstall *mobile_border](https://cdn.adguardvpn.com/content/kb/vpn/ios/2.2/quick-action-menu.png)

You can learn more about the AdGuard VPN app for iOS in [this article](adguard-vpn-for-ios/overview).
121 changes: 81 additions & 40 deletions docs/adguard-vpn-for-ios/overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ sidebar_position: 1

## What is AdGuard VPN for iOS?

A VPN allows you to create a secure connection to another network on the Internet. It connects a user's computer or mobile device to a server and allows one to browse the net using a "cover" IP address. If the VPN server is located in another country, it will appear as if the Internet connection was established from this country. [Learn more](/general/how-vpn-works) about how a VPN works in detail.
A VPN allows you to create a secure connection to another network on the Internet. It connects a users computer or mobile device to a server and allows one to browse the internet using a "cover" IP address. If the VPN server is located in another country, it will appear as if your Internet connection was established from this country. For more details, you can check [our article on how a VPN works](/general/how-vpn-works).

AdGuard VPN has several functions:

Expand All @@ -14,93 +14,134 @@ AdGuard VPN has several functions:
- encrypts your traffic and makes contents inaccessible to scammers
- lets you configure where to use VPN and where not to (exclusions feature)

The next advantage of AdGuard VPN for iOS is our own VPN protocol. It is extremely difficult to detect compared to other VPN protocols, and it is stable even with a poor Internet connection. You can [read more](/general/adguard-vpn-protocol) about the AdGuard VPN protocol.
The next advantage of AdGuard VPN for iOS is our own VPN protocol. It is extremely difficult to detect compared to other VPN protocols, and it is stable even with a poor Internet connection. [Read more about the AdGuard VPN protocol](/general/adguard-vpn-protocol).

## How to use AdGuard VPN for iOS

To use AdGuard VPN for iOS, first you need to log into your [AdGuard account](https://my.adguard.com/). You can sign in directly with your AdGuard account credentials, or via Google, Apple ID, or Facebook (if your AdGuard account was registered using the same email address).

If you don't have an AdGuard account yet, you will have to create it first.
If you dont have an AdGuard account yet, you will have to create it first.

Using AdGuard VPN is quite easy. On the main screen you can see the *Connect/Disconnect* button and the list of available servers. There servers have their own location (a certain country and a city) and ping indicator. The ping shows the server's response time (in milliseconds). Choosing the server with a ping of 22 ms means that a data packet sent to this server is returned (received again) after 22 ms. In AdGuard VPN you can choose among over 50 locations in dozens of countries.
Using AdGuard VPN is quite easy. On the main screen you can see the *Connect* (*Disconnect*) button and the list of available servers (we call them *locations*). Each server has its own location (a certain country and a city) and ping indicator.

![Main screen and locations *mobile_border](https://cdn.adguardvpn.com/content/kb/vpn/ios/1.png?123)
The ping shows the server’s response time in milliseconds. This indicates how fast the VPN connection will be when you connect to that location. Selecting a server with a ping of 22 ms means that a data packet sent to this server will be returned in 22 ms.

## Lists of exclusions
With AdGuard VPN, you can choose from over 50 locations in dozens of countries.

You can find Exclusions by tapping the middle button below. There you will see two exclusion lists, for General and Selective modes. In General mode, the VPN works for all websites except the excluded ones. Conversely, in Selective mode, the VPN only works for websites from the list. You can add domains (e.g. `google.com`) or subdomains (e.g. `*.google.com`) of websites in two ways: you can enter them manually in the app or directly from the browser by sharing the desired pages with AdGuard VPN.
![Main screen and locations *mobile_border](https://cdn.adguardvpn.com/content/kb/vpn/ios/2.2/main-locations.png)

![Exclusions *mobile_border](https://cdn.adguardvpn.com/content/kb/vpn/ios/2.png?123)
## Exclusions

Another useful feature is the import/export of exclusion lists. You can do it by following the next four steps:
You can find the Exclusions tab by tapping the second icon in the bottom bar. There you will see two exclusion lists, for *Regular* and *Selective* modes.

1. Open AdGuard VPN on the device/in the browser from where you want to export your lists of exclusions. Find the appropriate section and click the *Export* button. The `exclusions.zip` archive will be downloaded.
In *Regular* mode, the VPN works for all websites except the excluded ones. Conversely, in *Selective* mode, the VPN only works for websites from the list.

You can add domains (e.g. `google.com`) or subdomains (e.g. `*.google.com`) of websites to the lists in two ways:

- Enter them manually in the app
- Add them directly from the browser by sharing the desired pages with AdGuard VPN

![Exclusions *mobile_border](https://cdn.adguardvpn.com/content/kb/vpn/ios/2.2/exclusions-add.png)

### Import/export exclusions

Another useful feature is the import and export of exclusion lists. This way you can share exclusion lists from and to other devices.

You can do it in four steps:

1. Open AdGuard VPN on the device from where you want to export your lists of exclusions. Find the appropriate section and click the *Export* button. The `exclusions.zip` archive will be downloaded.

2. There are two `.txt` files inside the archive, one for each of General and Selective lists. Add more exclusions to them, delete the existing ones, rename files (but more on this later), or just leave the archive with files as is.

3. When transferring between different devices, don't forget to send the `.zip` file to the device for import. For example, if you import exclusion lists from your iOS device to your Mac, make sure to send the `.zip` file to your Mac beforehand.
3. When transferring between different devices, dont forget to send the `.zip` file to the device for import. For example, if you import exclusion lists from your iOS device to your Mac, make sure to send the `.zip` file to your Mac beforehand.

4. Open AdGuard VPN on the device where you want to import the archive with the ready lists of exclusions. Find the appropriate section, click the *Import* button and select the archive.

![Import/export exclusions *mobile_border](https://cdn.adguardvpn.com/content/kb/vpn/ios/import-export-exclusions.png)
**In AdGuard VPN for iOS, the export and import features can be accessed by tapping the three-dot icon in the upper right corner of the Exclusions screen**.

## App settings
![Import/export exclusions *mobile_border](https://cdn.adguardvpn.com/content/kb/vpn/ios/2.2/exclusions-3dot-menu.png)

To reach App settings:
## General settings

1. Tap Settings button (⚙) in the bottom right corner of the AdGuard VPN app's main screen
2. Tap *App settings*
To open General settings:

Here, you can configure AdGuard VPN for iOS as you need using different options: Operating Mode, DNS server, Wi-Fi auto-protection, Color Theme and Advanced Settings.
1. Tap the Settings icon (⚙) in the bottom right corner of the app’s main screen.
2. Tap *General*.

![App Settings *mobile_border](https://cdn.adguardvpn.com/content/kb/vpn/ios/app-settings.png)
Here, you can configure AdGuard VPN for iOS as you need using different options: *DNS server*, *Theme*, *Advanced*, *Send technical and interaction data* and *Kill Switch*.

### Operating mode
![General settings *mobile_border](https://cdn.adguardvpn.com/content/kb/vpn/ios/2.2/general-settings.png)

AdGuard VPN for iOS can operate in two modes: **General** and **Integrated**.
### DNS server

AdGuard VPN for iOS offers a choice between several DNS servers, each with their own special qualities. For example, AdGuard DNS removes ads and protects your device from tracking while AdGuard DNS Family Protection combines the functions of AdGuard DNS with Safe search and adult content blocking. DNS servers by different DNS providers may also work faster or slower depending on your location, ISP, and other factors. Choose the one that works best for you. You can [find out more about DNS](https://adguard-dns.io/kb/general/dns-filtering/#what-is-dns) and its characteristics.

In **General** mode, the [AdGuard VPN protocol](/general/adguard-vpn-protocol) is employed, which provides the best combination of speed and security. In this mode, AdGuard VPN will not be able to work alongside [AdGuard Ad Blocker for iOS](https://adguard.com/kb/adguard-for-ios/overview/).
![DNS server screen *mobile_border](https://cdn.adguardvpn.com/content/kb/vpn/ios/2.2/DNS-server.png)

### Theme

You can set your app theme to System, Dark, or Light (available in iOS 13 or later).

### Advanced settings

In **Integrated** mode, AdGuard VPN will be able to work at the same time with AdGuard Ad Blocker for iOS by using the IPSec protocol instead. This protocol is also secure, but a little slower and easier to detect. You don't need to perform any additional actions to set up the integration: just install both apps and switch to this mode.
In *Advanced* settings, you can find 4 sections — *Operating mode*, *Logging level*, *Export logs and system info*, and *Diagnostic info*.

#### Operating mode

AdGuard VPN for iOS can operate in two modes: **VPN** and **Integrated**.

The *VPN* mode uses the [AdGuard VPN protocol](/general/adguard-vpn-protocol), which provides the best combination of speed and security. In this mode, AdGuard VPN will not work with [AdGuard Ad Blocker for iOS](https://adguard.com/adguard-ios/overview.html).

In **Integrated mode**, AdGuard VPN will be able to work simultaneously with AdGuard Ad Blocker for iOS using the IPSec protocol. This protocol is also secure, but a bit slower and easier to detect. You don’t have to do anything to set up the integration: just install both apps and switch to this mode.

:::note

In **Integrated** mode, you can't use the Exclusions feature or choose a DNS server.
In **Integrated** mode, you cant use the Exclusions feature or choose a DNS server.

:::

### DNS server
#### Logging level

DNS servers translate a domain name or hostname (e.g., example.com or www.example.com) into something browsers can understand, i.e. IP addresses. AdGuard VPN for iOS offers a choice between several DNS servers, each with their own special qualities. For example, AdGuard DNS removes ads and protects your device from tracking while AdGuard DNS Family Protection combines the functions of AdGuard DNS with Safe search and adult content blocking. DNS servers by different DNS providers may also work faster or slower depending on your location, ISP, and other factors. Choose the one that works best for you. You can [find out more about DNS](https://adguard-dns.io/kb/general/dns-filtering/#what-is-dns) and its characteristics.
This setting is primarily used for debugging and troubleshooting purposes. The Extended and Extreme logging levels record more detailed information that can help identify and fix various problems or bugs.

![DNS server screen *mobile_border](https://cdn.adguardvpn.com/content/kb/vpn/ios/dns-server.png)
:::caution

### Wi-Fi auto-protection
**It is not recommended to enable the Extended or Extreme logging level unless requested by our support team**.

VPN will automatically turn on when the device connects to a Wi-Fi network.
:::

### Theme
#### Export logs ans system info

You can choose system default, dark or light theme of the app (available in iOS 13 and later versions).
This option can be used to send the app’s logs and system info to our support or anyone else.

### Advanced settings
#### Dignostic data

This option lets you export technical information that can be useful in solving problems and is sometimes requested by our support and developers.

### Send technical and intercation data

By turning this option on you are helping us understand better how users interact with the app. We use that information to improve user experience.

### Kill Switch

If for some reason your VPN connection suddenly drops, *Kill Switch* will automatically terminate the Internet connection, making sure your data doesn’t leak and your identity stays hidden.

In *Advanced settings* you can find two sections — Logging level and Diagnostic info. Concerning the first option, it is not recommended to enable the Extended logging level unless requested by our support team. Diagnostic info, locally stored technical information about the device and connections (IP address, ID, ping, etc.), can be sent to us in case of any technical problems.
## Quick actions

## Quick Actions (available in iOS 13 or later)
Quick actions are the convenient way to do useful or any app-specific actions from the Home screen without opening an app.

To access this feature, touch and hold the app icon, then lift your finger. You'll see quick actions: Connect/Disconnect, Select location, Edit Home Screen, and Remove app.
To access the quick actions menu, tap and hold the AdGuard VPN app icon, then lift your finger. In the opened menu, you will see AdGuard VPN’s quick actions: *Connect* (*Disconnect*) and *Select location*. You can also access all default actions like removing the app or moving or sharing the app.

![Quick actions *mobile_border](https://cdn.adguardvpn.com/content/kb/vpn/ios/quick-actions.png)
![Quick actions *mobile_border](https://cdn.adguardvpn.com/content/kb/vpn/ios/2.2/quick-action-menu.png)

## Support

There is a variety of helping features in the app (press the *Settings* button at the bottom right and then *Support*): you can see the FAQ section, report a bug, leave feedback, discuss your problems and suggestions in social networks or on GitHub, rate AdGuard VPN for iOS in the App Store and export logs.
The Support screen (*Settings* *Support*) has a number of helpful features: *FAQ*, *Report a bug*, *Request a feature*, and *Rate app*. The latter allows you to rate AdGuard VPN for iOS on the App Store.

![Support *mobile_border](https://cdn.adguardvpn.com/content/kb/vpn/ios/support.png)
![Support *mobile_border](https://cdn.adguardvpn.com/content/kb/vpn/ios/2.2/support.png)

## Subscription
## Subscription screen

If you are using the free version of AdGuard VPN, there will be the fourth tab with an arrow icon on the bottom tab bar. In this section you will find brief information about the main advantages of the paid version of the app and will be able to buy a subscription.
If you are using the free version of AdGuard VPN, there will be another tab with an arrow icon on the bottom tab bar. This section briefly describes the main benefits of the paid version of the app. You can choose a yearly or monthly subscription.

![Subscription *mobile_border](https://cdn.adguardvpn.com/content/kb/vpn/ios/subscription_en.png)
![Subscription *mobile_border](https://cdn.adguardvpn.com/content/kb/vpn/ios/2.2/unlimited.png)
15 changes: 5 additions & 10 deletions docs/adguard-vpn-for-ios/solving-problems/_category_.json
Original file line number Diff line number Diff line change
@@ -1,11 +1,6 @@
{

"position": 3,

"label": "Solving problems",

"collapsible": true,

"collapsed": true

}
"position": 3,
"label": "Solving problems",
"collapsible": true,
"collapsed": true
}
12 changes: 6 additions & 6 deletions docs/adguard-vpn-for-ios/solving-problems/access-issues.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,16 +3,16 @@ title: Usage issues with subscriptions purchased via the App Store
sidebar_position: 4
---

Some users can't use their AdGuard VPN subscription purchased through the App Store. This issue may occur in two cases:
Some users cant use their AdGuard VPN subscription purchased through the App Store. This issue may occur in two cases:

- if you use a different account for App Store purchases
- or if you have hidden your email address from app developers

To solve this problem, please follow these steps:

1. Go to Settings → Apple ID Media & Purchases → View Apple ID
1. Make sure that the email address matches the one you use for your Apple ID
1. If the email addresses do not match, please email to `[email protected]`: describe your problem and provide us with the address used for the App Store
1. If the email addresses match, navigate to Apple ID → iCloud → Hide My Email, find our app in the list, copy the email address, and send it to `[email protected]` along with your problem description. Usually, it ends with "@privaterelay.appleid.com"
1. Go to iOS Settings → [your Apple ID name] → *Media & Purchases**View Account*.
1. Make sure that the email address matches the one you use for your Apple ID.
1. If the email addresses do not match, please email to `[email protected]`: describe your problem and provide us with the address used for the App Store.
1. If the email addresses match, navigate to *Apple ID**iCloud**Hide My Email*, find our app in the list, copy the email address, and send it to `[email protected]` along with a description of your problem. Usually, such an email address ends with `@privaterelay.appleid.com` or `@icloud.com`.

Once the support team has the email address you used for the purchase, they'll transfer your subscription to the correct account and you'll be able to start using it. Or they may ask for additional information. You can provide the support team with your Apple purchase receipt to help speed up the process.
Once the support team has the email address you used for the purchase, theyll transfer your subscription to the correct account and youll be able to start using it. They also may ask for additional information to verify that it’s you. You can provide the support team with your Apple purchase receipt to help speed up the process.
Loading
Loading