Merge pull request #44 from DefGuard/mobile-client

Improving Defguard mobile wiki

Author: jakub-tldr

.gitbook/assets/defguard-add-instance-qr.png

@@ -4,25 +4,49 @@
 Mobile client is currently under development, current page should be considered as preview. Some parts of UI may look diffrent in upcoming release.
 {% endhint %}
 
+### Overview
+This guide explains how to use the Defguard Mobile to connect securely to VPN locations managed within your Defguard [instance](#what-is-an-instance). It covers the entire process, from installation, adding new instances, connecting to locations, to managing your VPN connection settings.
+
+
+
 ### Installation
 
 Download for [iOS](https://defguard.net) or [Android](https://defguard.net) (Coming soon!)
 
 ### Quick guide
+- [How to add instance?](#adding-new-instance-by-qr-or-manually)
+- [How to connect to location without MFA?](#connecting-to-location-without-mfa)
+- [How to connect to location with MFA?](#connecting-to-location-with-mfa)
+- [How can I obtain QR Code?](#how-can-i-obtain-qr-code-url-and-token)
+- [What is an instance?](#what-is-an-instance)
+- [Supported MFA methods](#supported-mfa-methods)
+- [Additional features](#additional-features)
+### Connecting made effortless 
+
+<figure><img src="../.gitbook/assets/defguard-mobile-connecting.gif" width=50% alt=""></figure>
 
-* [How to add instance?](mobile-client.md#adding-new-instance-by-qr-or-manually)
-* [How to connect to location without MFA?](mobile-client.md#connecting-to-location-without-mfa)
-* [How to connect to location with MFA?](mobile-client.md#connecting-to-location-with-mfa)
-* [Supported MFA methods](mobile-client.md#supported-mfa-methods)
-* [Additional features](mobile-client.md#additional-features)
 
-### Connecting made effortless
 
-<figure><img src="../.gitbook/assets/defguard-mobile-connecting.gif" alt="" width="333"><figcaption></figcaption></figure>
+### Adding new instance
+
+<figure><img src="../.gitbook/assets/defguard-mobile-new-instance.jpg" width=50% alt=""></figure>
+
+{% hint style="info" %}
+**Before** proceeding, please read [this](#how-can-i-obtain-qr-code-url-and-token) 
+{% endhint %}
+
+#### Add instance by QR Code
+1. Go to "Add Instance" tab
+2. Click "Scan QR Code"
+3. Scan QR code
+4. Enter name
 
-### Adding new instance (by QR or manually)
+#### Add instance manually
+1. Go to "Add Instance" tab
+2. Click "Add Instance Manually"
+3. Enter URL and token
+4. Confirm
 
-<figure><img src="../.gitbook/assets/defguard-mobile-new-instance.jpg" alt="" width="375"><figcaption></figcaption></figure>
 
 {% hint style="warning" %}
 Your phone will need to add new VPN configuration, when you see the request, please allow it. Without this permission, Defguard cannot establish VPN connection.
@@ -45,23 +69,44 @@ Your phone will need to add new VPN configuration, when you see the request, ple
    * Predefined traffic (Faster for general browsing)
    * All traffic (Full encryption and privacy)
 4. Choose MFA method which is configured in your account
-   * Email
-   * Authenticator App
-   * Biometric
+    - Email
+    - Authenticator App
 5. Authenticate and connect.
 
 {% hint style="warning" %}
 If your instance have configured external OpenID authentication, it will be used as primary method for MFA
 {% endhint %}
 
+### How can I obtain QR Code, URL and token?
+1. Login to your Defguard instance
+2. Go to "My Profile" tab
+3. Click "Add new device" in "User devices" tab
+<figure><img src="../.gitbook/assets/defguard-myprofile-add-device.png" width=50% alt=""></figure>
+4. Select "Remote Device Activation" and click "Next"
+<figure><img src="../.gitbook/assets/defguard-add-new-device.png" width=50% alt=""></figure>
+5. You will see URL, Authentication token and **QR Code**
+<figure><img src="../.gitbook/assets/defguard-add-instance-qr.png" width=50% alt=""></figure>
+
+### What is an instance?
+An instance contains locations. These are the servers you can connect to via VPN. When you use the Defguard Mobile, you select an instance first, and then choose the specific location within it to establish your VPN connection.
+
+#### Instance list
+<figure><img src="../.gitbook/assets/defguard-instance-list.jpg" width=50% alt=""></figure>
+
+#### Location list (inside instance)
+<figure><img src="../.gitbook/assets/defguard-location-list.jpg" width=50% alt=""></figure>
+
+
+
 ### Supported MFA Methods
 
 Defguard Mobile supports multiple secure authentication methods:
+- **TOTP** – time‑based one‑time passwords (Authenticator apps)  
+- **Email** – receive verification codes via email  
+- **OpenID** – integrate with any OpenID Connect provider (Google, etc.)
+
+
 
-* **TOTP** – time‑based one‑time passwords (Authenticator apps)
-* **Email** – receive verification codes via email
-* **Biometry** – Touch ID / Face ID support
-* **OpenID** – integrate with any OpenID Connect provider (Google, etc.)
 
 ## Additional features