> For the complete documentation index, see [llms.txt](https://docs.nexthink.com/platform/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nexthink.com/platform/configuring_nexthink/bringing-data-into-your-nexthink-instance/connecting-mobile-devices-to-nexthink/deploying-nexthink-mobile-in-workspace-one.md).

# Deploying Nexthink Mobile in Omnissa Workspace ONE

This guide explains how to deploy the Nexthink Mobile app for Android, iOS, and iPadOS devices in Omnissa Workspace ONE UEM. It is intended for IT administrators responsible for device management and Nexthink onboarding, and it assumes familiarity with mobile device management concepts and with administering Workspace ONE UEM.

Both platforms use the same Workspace ONE UEM console and share most of the procedure. The steps that differ by platform are shown in the **Android** and **iOS and iPadOS** tabs.

***

## Before you begin

Before starting the deployment, ensure you meet the following requirements:

* Target devices are enrolled in Workspace ONE UEM.
* Target Android devices have access to Google Play, and target iOS and iPadOS devices have access to Apple App Store.
* For iOS and iPadOS devices, download and configure the `Nexthink Mobile Device Configuration Profile.xml` file as described in the [Nexthink Mobile device configuration profile for iOS and iPadOS](https://edocs.nexthink.com/nexthink-infinity/infinity-specifications/nexthink-mobile-app-configuration-profile-ios) documentation.
* Create an installation token as described in 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.

{% hint style="info" %}
Nexthink Mobile supports Android 13 or later and Apple iOS 17.3 or later.
{% endhint %}

***

## Adding the Nexthink Mobile app

Add Nexthink Mobile as a public app in the Workspace ONE UEM console.

{% stepper %}
{% step %}
Select **Resources > Apps > Native Apps**, open the **Public** tab, and select **Add Application**.

<figure><img src="https://268444917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxJSUDk9NTtCHYPG5EWs3%2Fuploads%2F7sX4JjFUSV4paHXgq4sz%2Fimage.png?alt=media&#x26;token=4b47173b-37d6-45f2-bd8c-24657ab1d83d" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
In the **Add Application** dialog, set **Managed By** to your organization group, then select the target **Platform**.

{% tabs %}
{% tab title="Android" %}

1. Select **Android** as the **Platform**.
2. Select **Search App Store**, then select **Search**.
3. In Google Play, search for "Nexthink Mobile" and select the app published by Nexthink SA.

<figure><img src="https://268444917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxJSUDk9NTtCHYPG5EWs3%2Fuploads%2F3lcMy041jcCkjoiCgHL8%2Fimage.png?alt=media&#x26;token=e532cd16-3b73-413e-b4d7-a3197c5cda71" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="iOS and iPadOS" %}

1. Select **Apple iOS** as the **Platform**.
2. Select **Search**.
3. In the search dialog, set **Search Application** to "Nexthink Mobile", select the **Country**, and select **Select** on the Nexthink Mobile result.

<figure><img src="https://268444917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxJSUDk9NTtCHYPG5EWs3%2Fuploads%2Fstm2jxmz2mZvoouhCxAn%2Fimage.png?alt=media&#x26;token=49a87430-6422-4263-9da2-0a9794a0d8de" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}
{% endstep %}

{% step %}
On the **Details** tab, confirm the **Name** is "Nexthink Mobile" and, optionally, set the **Categories**. Select **Save & Assign**.

{% hint style="info" %}
On Android, Workspace ONE UEM adds the app directly from Google Play. Edit its **Details**, including the **Categories**, at any time by opening the app and selecting **Edit**.
{% endhint %}

<figure><img src="https://268444917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxJSUDk9NTtCHYPG5EWs3%2Fuploads%2FpJthxKQiB24M99YQDeNc%2Fimage.png?alt=media&#x26;token=a5f1f11a-d6cc-409a-a5a2-bd90212872b6" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

***

## Configuring the content filter for iOS and iPadOS

For iOS and iPadOS devices, deploy the Nexthink Mobile device configuration profile as a **Custom Settings** profile with custom value lookup enabled, so that Workspace ONE UEM substitutes per-device values, such as the device identifier and user principal name (UPN). Android devices do not require this profile; you configure Android through the app assignment, as described in [Assigning the app and sending its configuration](#assigning-the-app-and-sending-its-configuration).

Refer to the [Nexthink Mobile device configuration profile for iOS and iPadOS](https://edocs.nexthink.com/nexthink-infinity/infinity-specifications/nexthink-mobile-app-configuration-profile-ios) documentation for the full configuration steps in Workspace ONE UEM.

***

## Assigning the app and sending its configuration

Assign Nexthink Mobile to the target device groups. For Android devices, you also send the app configuration in the same step.

{% stepper %}
{% step %}
Open the Nexthink Mobile app from the app list, select the **Assignments** tab, then select **Assign**.

<figure><img src="https://268444917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxJSUDk9NTtCHYPG5EWs3%2Fuploads%2FsfX8PkSF3rUli6OzmanU%2Fimage.png?alt=media&#x26;token=7994fcef-126e-48f7-b6c6-82a6d00f168d" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
On the **Distribution** page, set the following values:

* **Name**: Add a meaningful name for the assignment.
* **Assignment Groups**: Add the device groups to which you want to assign the app.
* **App Delivery Method**: Select **Auto** to install the app automatically, or **On Demand** to let employees install it themselves.

<figure><img src="https://268444917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxJSUDk9NTtCHYPG5EWs3%2Fuploads%2FMdZZSYMSUa7pC8V0Wze9%2Fimage.png?alt=media&#x26;token=39b43b73-c92e-4297-b59c-3d1d741b6e8b" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Configure the app for your platform.

{% tabs %}
{% tab title="Android" %}
Enable **Send Configuration**, then set the following configuration keys:

<table data-full-width="true" data-search="false"><thead><tr><th width="220">Configuration key</th><th>Value</th></tr></thead><tbody><tr><td>Unique Device Identifier</td><td><p>Insert the <code>{DeviceUuid}</code> lookup value.</p><p>⚠️ This is needed to ensure correct functionality with the connector.</p></td></tr><tr><td>Device Tag</td><td>Add an optional identifier that can be used to tag devices.</td></tr><tr><td>Nexthink Installation Token</td><td>The installation token you generated for your Nexthink tenant.</td></tr><tr><td>Nexthink Proxy URL</td><td><p>The URL of your Nexthink tenant, according to the following pattern:</p><ul><li><code>https://&#x3C;instance>.data.&#x3C;region>.nexthink.cloud</code></li><li>Example: <code>https://instance.data.eu.nexthink.cloud</code></li></ul></td></tr><tr><td>Data Upload Network Preference</td><td>Select <strong>Upload Always</strong> to upload data over both Wi-Fi and mobile data.</td></tr><tr><td>Force Show Settings Screen</td><td>Select <strong>Disable</strong> to hide the settings screen, or <strong>Enable</strong> to show it.</td></tr><tr><td>Primary user UPN</td><td>Insert the <code>{EmailAddress}</code> lookup value.</td></tr><tr><td>Support email address</td><td>Insert the <code>{EnrollmentSupportEmail}</code> lookup value. Nexthink Mobile sends logs to this address.</td></tr><tr><td>Collect Network Identifiers</td><td>Select <strong>Enable</strong> to collect the SSID and BSSID of the connecting network, or <strong>Disable</strong> to skip collection.</td></tr></tbody></table>
{% endtab %}

{% tab title="iOS and iPadOS" %}
iOS and iPadOS devices receive the app configuration from the content filter profile configured in [Configuring the content filter for iOS and iPadOS](#configuring-the-content-filter-for-ios-and-ipados). No further configuration is required in the assignment.
{% endtab %}
{% endtabs %}
{% endstep %}

{% step %}
Select **Create**, review the assigned devices, then select **Publish**.

<figure><img src="https://268444917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxJSUDk9NTtCHYPG5EWs3%2Fuploads%2FzF6B3PjnEh77zubESIKH%2Fimage.png?alt=media&#x26;token=f0e3e6c9-0795-4469-a0a6-ea0b7d60491d" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

***

## Setting silent installation for Android

For Android devices, set Nexthink Mobile to install silently so that it deploys automatically without employee interaction.

{% stepper %}
{% step %}
Open the Nexthink Mobile Android app and select **Edit**.
{% endstep %}

{% step %}
On the **Details** tab, set **Is App Restricted to Silent Install** to **Yes**.

<figure><img src="https://268444917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxJSUDk9NTtCHYPG5EWs3%2Fuploads%2FiSQL9iWtvb0RkJlZTsE8%2Fimage.png?alt=media&#x26;token=5d80b01c-0b79-4e90-af36-93b678c8f59e" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Select **Save & Assign**.
{% endstep %}
{% endstepper %}

***

## Verifying onboarding and data collection

{% stepper %}
{% step %}

### Verify configuration on the device

Confirm the configuration file is running correctly as described in the [Nexthink Mobile device configuration profile for iOS and iPadOS](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; change the `<app-uid>` to the actual app ID:

{% 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.
{% endstep %}
{% endstepper %}

***

## Configuring 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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.nexthink.com/platform/configuring_nexthink/bringing-data-into-your-nexthink-instance/connecting-mobile-devices-to-nexthink/deploying-nexthink-mobile-in-workspace-one.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.