> For the complete documentation index, see [llms.txt](https://docs.defguard.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.defguard.net/1.6/using-defguard-for-end-users/mobile-client/instance-adding.md).

# Adding new Instance

In this guide, you will learn how to add Instance in mobile app.

If you are after the enrollment process, please follow [this guide](#adding-instance-in-defguard)

## Enrollment via external SSO

1. Go to your enrollment page. Click **Select** under "Enrollment process".

<figure><img src="https://3466771104-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe86iamwJVSYnIRsyVEAV%2Fuploads%2Fgit-blob-2f7710cf7e3025aefc13465645a174c991a7f75c%2Fdefguard-enrollment-options.png?alt=media" alt="" width="50%"><figcaption></figcaption></figure>

2. In this example we use Google as OIDC provider so our button is "Sign in with Google". Your organization can use different OIDC provider.

<figure><img src="https://3466771104-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe86iamwJVSYnIRsyVEAV%2Fuploads%2Fgit-blob-f0fe644716ec2bc5ee1f7372d8721682e2cb70e0%2Fdefguard-enrollment-by-sso.png?alt=media" alt="" width="50%"><figcaption></figcaption></figure>

3. You will be redirected to your OIDC provider login page, please log in. After doing this, you will be redirected and shown a screen with **URL, Token and QR Code**.

<figure><img src="https://3466771104-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe86iamwJVSYnIRsyVEAV%2Fuploads%2Fgit-blob-aebf53c934d77926b37814b0db5ae135ac22e047%2Fdefguard-enrollment-sso-qr-url.png?alt=media" alt="" width="50%"><figcaption></figcaption></figure>

4. Open Defguard Mobile on your smartphone
5. Click **Scan QR Code**

<figure><img src="https://3466771104-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe86iamwJVSYnIRsyVEAV%2Fuploads%2Fgit-blob-652eab2f16d7a62af3921f331ee9b785e298d92f%2Fdefguard-mobile-add-instance.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

6. Scan QR generated in step 3.
7. Enter the name of your device. For example "iPhone 11"
8. Confirm

{% hint style="info" %}
If you can't scan QR Code, select **Add Instance Manually** in **step 5** and enter URL and Token from **step 3**.
{% endhint %}

## Enrollment via Email

Find enrollment **Instance URL** and **Token** in your "Defguard user enrollment" email. It should look like this:

<figure><img src="https://3466771104-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe86iamwJVSYnIRsyVEAV%2Fuploads%2Fgit-blob-5156752f5145640866bac4c50a5a9194a3715069%2Fdefguard-enrollment-email.png?alt=media" alt="" width="50%"><figcaption></figcaption></figure>

If you want to enroll via Web Browser, click **Start enrollment** or:

1. Go to your enrollment page. Click **Select** under "Enrollment process".

<figure><img src="https://3466771104-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe86iamwJVSYnIRsyVEAV%2Fuploads%2Fgit-blob-2f7710cf7e3025aefc13465645a174c991a7f75c%2Fdefguard-enrollment-options.png?alt=media" alt="" width="50%"><figcaption></figcaption></figure>

2. Enter your **Token** and click **Send**.

<figure><img src="https://3466771104-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe86iamwJVSYnIRsyVEAV%2Fuploads%2Fgit-blob-75f19dcf67a0d9fa68a071eb47f7f7f838ef385f%2Fdefguard-enrollment-by-token.png?alt=media" alt="" width="50%"><figcaption></figcaption></figure>

Now, follow [Enrollment via Web Browser](#enrollment-via-web-browser) guide.

## Enrollment via Web Browser

1. Upon starting enrollment process you will see something like this: **Before proceeding, read the text carefully, as it may contain important information given by your administrator,** then click **Next**.

<figure><img src="https://3466771104-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe86iamwJVSYnIRsyVEAV%2Fuploads%2Fgit-blob-093e9af25b20e4b8a628b8bba95b42e22e837157%2Fdefguard-enrollment-step1.png?alt=media" alt="" width="50%"><figcaption></figcaption></figure>

2. In this step you can optionally enter your phone number after entering it. Proceed by clicking the **Next** button.

<figure><img src="https://3466771104-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe86iamwJVSYnIRsyVEAV%2Fuploads%2Fgit-blob-ab0e703bc4d6d5b546ba957fbdd60f2f5e128dc1%2Fdefguard-enrollment-step2.png?alt=media" alt="" width="50%"><figcaption></figcaption></figure>

3. Now, you need to set up your password. After entering the password, proceed by clicking **Next**.

<figure><img src="https://3466771104-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe86iamwJVSYnIRsyVEAV%2Fuploads%2Fgit-blob-405deea408a7e1410420711045ef09a753104020%2Fdefguard-enrollment-step3.png?alt=media" alt="" width="50%"><figcaption></figcaption></figure>

4. This is the step where we can add our mobile device. Enter the name of your device, then click **Create Configuration**.

<figure><img src="https://3466771104-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe86iamwJVSYnIRsyVEAV%2Fuploads%2Fgit-blob-c02eefe592883fb34b6d88fce00c1f2f1fe73ea1%2Fdefguard-enrollment-step4.png?alt=media" alt="" width="50%"><figcaption></figcaption></figure>

5. You will see a screen like this.

<figure><img src="https://3466771104-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe86iamwJVSYnIRsyVEAV%2Fuploads%2Fgit-blob-2bfbef5df9369f4f3ebfb2ddff61c0157e471a4f%2Fdefguard-enrollment-step4-qr.png?alt=media" alt="" width="50%"><figcaption></figcaption></figure>

6. Open Defguard on your mobile device. Click **Scan QR Code**, and scan the code from **step 5**.

<figure><img src="https://3466771104-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe86iamwJVSYnIRsyVEAV%2Fuploads%2Fgit-blob-652eab2f16d7a62af3921f331ee9b785e298d92f%2Fdefguard-mobile-add-instance.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

7. After scanning the QR code, enter the name of your device and confirm.

{% hint style="info" %}
If you can't scan QR Code, select **Add Instance Manually** in **step 6** and enter URL and Token from **step 5**.
{% endhint %}

## Adding Instance in Defguard

1. Log in to your Defguard account.
2. Go to **My Profile** tab.
3. Click **Add new device** button inside **User Devices** list.

<figure><img src="https://3466771104-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe86iamwJVSYnIRsyVEAV%2Fuploads%2Fgit-blob-d42faf87c260a0abfd7881782b854ff5bdc374ac%2Fdefguard-myprofile-add-device.png?alt=media" alt="" width="50%"><figcaption></figcaption></figure>

4. Select **Remote Device Activation** and click **Next**.

<figure><img src="https://3466771104-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe86iamwJVSYnIRsyVEAV%2Fuploads%2Fgit-blob-e3934c3349aac5917767ebaa169a91cfda71dfc5%2Fdefguard-add-new-device.png?alt=media" alt="" width="50%"><figcaption></figcaption></figure>

5. After that you will see URL, Token and QR Code. **Take a screenshot of QR code**, we will need it in next step.

<figure><img src="https://3466771104-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe86iamwJVSYnIRsyVEAV%2Fuploads%2Fgit-blob-c5903ac66e962bffc60a63241dc2288012a3610d%2Fdefguard-add-instance-qr.png?alt=media" alt="" width="50%"><figcaption></figcaption></figure>

6. Open Defguard Mobile on your smartphone
7. Click **Scan QR Code**

<figure><img src="https://3466771104-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe86iamwJVSYnIRsyVEAV%2Fuploads%2Fgit-blob-652eab2f16d7a62af3921f331ee9b785e298d92f%2Fdefguard-mobile-add-instance.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

8. Scan QR generated in step 5.
9. Enter the name of your device. For example "iPhone 11"
10. Confirm

{% hint style="info" %}
If you can't scan QR Code, select **Add Instance Manually** in **step 4** and enter URL and Token from **step 5**.
{% endhint %}
