# Configuring and deploying for iOS

This guide explains how to deploy the Nexthink Mobile application for iOS devices. It is intended for IT administrators responsible for device management and Nexthink onboarding, and it assumes familiarity with iOS device management concepts and with administering a Unified Endpoint Management (UEM) solution.

## Before you begin

Before starting the deployment, ensure that the following requirements are met:

* Ensure the target devices are supervised and enrolled in a UEM solution, such as Microsoft Intune or Jamf. This documentation uses Intune as an example.
* Ensure the target devices have access to Apple App Store.
* Download and configure the `Nexthink App configuration.xml` file as described in [Nexthink Mobile app configuration profile (iOS)](https://edocs.nexthink.com/nexthink-infinity/infinity-specifications/nexthink-mobile-app-configuration-profile-ios) documentation.
* Obtain an installation token; refer to the [creating-an-installation-token](https://docs.nexthink.com/platform/configuring_nexthink/bringing-data-into-your-nexthink-instance/connecting-mobile-devices-to-nexthink/creating-an-installation-token "mention") documentation.

## Adding Nexthink Mobile

Perform the following steps to add Nexthink Mobile to Intune.

{% stepper %}
{% step %}
Select **Apps > iOS/iPadOS > Create**.
{% endstep %}

{% step %}
For **App type**, select **iOS store app.**

<figure><img src="https://268444917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxJSUDk9NTtCHYPG5EWs3%2Fuploads%2FFdz7st4El6Epnr2v8dtU%2FiOS_step2_2026-03-26_12-11-31.png?alt=media&#x26;token=1ca844ad-ed88-4288-85d2-40c114dcec44" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
In the iOS Store, go to the **Search the App Store**.
{% endstep %}

{% step %}
Search for the keyword "Nexthink Mobile" and install the app from the search result:

<figure><img src="https://268444917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxJSUDk9NTtCHYPG5EWs3%2Fuploads%2FszmyjM1QaRk2owdUYqmu%2FiOS_mobile_step3_2026-03-25_16-53-33.png?alt=media&#x26;token=d9645378-deab-4352-8278-055a3a884f7e" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Configure **App information**:

* Set **Minimum operating system**: 17.0
* Choose **Applicable device type**: iPad and iPhone and iPod

<figure><img src="https://268444917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxJSUDk9NTtCHYPG5EWs3%2Fuploads%2F1Nx0xOgCuoWioymg62jt%2FiOS_step_5_2026-03-26_12-21-14.png?alt=media&#x26;token=3181f7ae-f772-40be-9eb7-6d62332ec97d" alt="" width="563"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Assign the application to the applicable mobile device groups.

<figure><img src="https://268444917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxJSUDk9NTtCHYPG5EWs3%2Fuploads%2Fvtd3YMnCWJAlnnR0Igea%2FiOS_step_7_2026-03-26_10-37-10.png?alt=media&#x26;token=362b4c10-b111-4404-afa6-4750564891c1" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Click **Next**, then select **Create** to finalize the app creation.

<figure><img src="https://268444917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxJSUDk9NTtCHYPG5EWs3%2Fuploads%2FsKBYN3g33x3GgZ9ZURF3%2FiOS_step_82026-03-26_10-38-03.png?alt=media&#x26;token=79622826-a99f-44e2-ba35-34db334dd1bb" alt="" width="563"><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

***

## Creating custom configuration profile

Create an app configuration policy and assign it to your Entra ID groups by following the steps below:

{% stepper %}
{% step %}
In Intune, go to **Devices > iOS/iPadOS > Configuration**
{% endstep %}

{% step %}
Select  **Create > New Policy** and set the following values:

* **Platform**: iOS/iPadOS
* **Profile type**: Templates
* **Template name**: Custom

Click **Create**.

<figure><img src="https://268444917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxJSUDk9NTtCHYPG5EWs3%2Fuploads%2FwxQLv1Mvff5Z7dOGJaWo%2Fimage.png?alt=media&#x26;token=5d5345f2-bc57-4277-bb03-f72646a39432" alt="" width="563"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Add a meaningful name for the template and select **Next**:

<figure><img src="https://268444917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxJSUDk9NTtCHYPG5EWs3%2Fuploads%2FxP7YqlpnoQEsvdfCE0RF%2Fimage.png?alt=media&#x26;token=9143595c-7d6d-4603-a4a2-71d7f08bb406" alt="" width="563"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Add a meaningful name for the profile and upload the configuration XML file that you have obtained from [Nexthink Mobile app configuration profile (iOS)](https://edocs.nexthink.com/nexthink-infinity/infinity-specifications/nexthink-mobile-app-configuration-profile-ios):

<figure><img src="https://268444917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxJSUDk9NTtCHYPG5EWs3%2Fuploads%2FWZ96CVv3vQridMud51Bj%2Fmobile-content-filter-8v1PfCIkZ77q6O3x.png?alt=media&#x26;token=3a8d5032-d841-431d-8113-3fe3c98eb4e1" alt="" width="563"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Confirm the correct values in the configuration file according to the [Nexthink Mobile app configuration profile (iOS)](https://edocs.nexthink.com/nexthink-infinity/infinity-specifications/nexthink-mobile-app-configuration-profile-ios) documentation. Click **Next**.
{% endstep %}

{% step %}
Assign the policy to the applicable mobile device groups. Once done, click **Next**, and then **Create** the profile.

<figure><img src="https://268444917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxJSUDk9NTtCHYPG5EWs3%2Fuploads%2FGJW2DECgst6xX0lnax5g%2Fimage.png?alt=media&#x26;token=cb9c1c2f-4eb5-4613-aa2e-35ebc6fa2aaf" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

***

## Verify onboarding and data collection

{% stepper %}
{% step %}

### Verify configuration on the device

Confirm the configuration file is running correctly according to the [Nexthink Mobile app configuration profile (iOS)](https://edocs.nexthink.com/nexthink-infinity/infinity-specifications/nexthink-mobile-app-configuration-profile-ios) documentation.
{% endstep %}

{% step %}

### Verify device visibility in Nexthink

In Nexthink, confirm that the device is reporting data by running the following investigation:

{% code overflow="wrap" %}

```sql
mobile_devices during past 1h
| where mobile_device.uid in ["<app-uid>"]
| list mobile_device.name, mobile_device.hardware.model, mobile_device.operating_system.name, mobile_device.uid, mobile_device.primary_user_upn
```

{% endcode %}

If the device appears in the query results, onboarding is successful.

<figure><img src="https://268444917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxJSUDk9NTtCHYPG5EWs3%2Fuploads%2F09QQhAYdIVHlRvWYmoDz%2Fimage.png?alt=media&#x26;token=8fe56b36-0af3-47b4-8336-f82a9f45acc6" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

***

## Configure Nexthink Mobile on client devices (optional)

If needed, see the [configuring-on-client-devices](https://docs.nexthink.com/platform/configuring_nexthink/bringing-data-into-your-nexthink-instance/connecting-mobile-devices-to-nexthink/configuring-on-client-devices "mention") documentation to learn how to configure Nexthink Mobile on client devices.