# 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](/platform/configuring_nexthink/bringing-data-into-your-nexthink-instance/connecting-mobile-devices-to-nexthink/creating-an-installation-token.md) 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="/files/YEP4ajDe1BRmhOBl3kny" 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="/files/3Yq4fkaiyFnjrH9NKsx4" 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="/files/wi5lzImQf35oQI80FOMm" alt="" width="563"><figcaption></figcaption></figure>
{% endstep %}

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

<figure><img src="/files/ViT0tixmg9K0Zm0YgISv" alt=""><figcaption></figcaption></figure>
{% endstep %}

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

<figure><img src="/files/IMivJxzZCmTbzzA9YnfM" 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="/files/gJhDT245ptWj1Dx3tQhR" alt="" width="563"><figcaption></figcaption></figure>
{% endstep %}

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

<figure><img src="/files/ohRfFcgraydg3VbR8e3m" 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="/files/FoqYJcyV2qkE4Ag5pFme" 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="/files/tGhhYkj9jy2j1TkHJ9NL" 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="/files/9N7Xa241Kx3Rwkc9DZDR" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

***

## Configure Nexthink Mobile on client devices (optional)

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


---

# 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.nexthink.com/platform/configuring_nexthink/bringing-data-into-your-nexthink-instance/connecting-mobile-devices-to-nexthink/nexthink-mobile-for-ios.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.