# 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="/files/lyrrLhYxEu3rOmFTpEqd" 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="/files/P53v5qFRB9m4p9QPirqj" 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="/files/R7CZw5andMEsPsIERcuT" alt="" width="50%"><figcaption></figcaption></figure>

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

<figure><img src="/files/skKVAsemAmrXWFBYMpgG" 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="/files/g0P2TmvbAX6JNXUo2ovn" 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="/files/lyrrLhYxEu3rOmFTpEqd" alt="" width="50%"><figcaption></figcaption></figure>

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

<figure><img src="/files/cLIl5IYHZQJShl7YNaAy" 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="/files/mME6fLL8uw4XKlkHnDB6" 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="/files/Zg5ksXoVEn7f1MPO7emh" 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="/files/90eScn9TBz0kyE1jddAL" 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="/files/sZq53A5LLVRb6XVRoPzJ" alt="" width="50%"><figcaption></figcaption></figure>

5. You will see a screen like this.

<figure><img src="/files/BEtp562X2AR3y74ewbfs" 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="/files/skKVAsemAmrXWFBYMpgG" 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="/files/03WWJ67LMj8MHFZhMmht" alt="" width="50%"><figcaption></figcaption></figure>

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

<figure><img src="/files/Pt2e4vin8EYu409orWQB" 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="/files/iQXgNMvHXLP2U6vZb0Wh" alt="" width="50%"><figcaption></figcaption></figure>

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

<figure><img src="/files/skKVAsemAmrXWFBYMpgG" 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.defguard.net/1.6/using-defguard-for-end-users/mobile-client/instance-adding.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
