# Mobile Device Management
> Configure and distribute the Orchestrator Mobile app to company-managed devices using a mobile device management tool.
You can make use of a mobile device management (MDM) tool to distribute the Orchestrator Mobile app with specific configurations to company-managed mobile devices. You can use these configurations to distribute On-premise Orchestrator Instance URLs and automatically disable telemetry for your users.
## Supported MDM Platforms
* VMWare Airwatch (a.k.a. Workspace One)
* Microsoft Intune (a.k.a. Endpoint Manager)
## VMWare Airwatch Setup
### Android
1. In Workspace ONE, navigate to **App & Books** > **Native**
2. In List View, select **Public** > **Add Application**. The **Add Application** window is displayed.
3. On the **Platform** field, select **Android**. Find the Orchestrator app:
* Search by name for `UiPath Orchestrator`.
4. Now that you’ve found the Orchestrator app, Select **Select**. This should take you to the following screen.
5. Select **Save & Assign** when you’re ready to continue.
6. If you want to add specific configurations, on the next pop-up, go to **Application Configuration**. The **Application Configuration** window is displayed.
7. Enable the **Send Configuration** option. This displays a list of the configuration keys you can set values to. Please check the **Configuration Keys** section below for more info on each configuration key.
8. Select the users/devices/groups you want to assign this app & configuration to and **Distribute** it.
### IOS
1. In Workspace ONE, navigate to **App & Books** > **Native**
2. In List View, select **Public** > **Add Application**. The **Add Application** window is displayed.
3. On the **Platform** field, select **Apple iOS**. Find the Orchestrator app:
* Search by name for `UiPath Orchestrator`.
4. Now that you’ve found the Orchestrator app, Select **Select**. This should take you to the following screen.
5. Select **Save & Assign** when you’re ready to continue.
6. If you want to add specific configurations, on the next pop-up, go to **Application Configuration**. The **Application Configuration** window is displayed.
7. Enable the **Send Configuration** option. From here you can add Configuration Keys or Upload an XML. Please check the **Configuration Keys** section below for more info on each configuration key.
8. Select the users/devices/groups you want to assign this app & configuration to and **Distribute** it.
## Microsoft Intune Setup
### Android
1. In Intune/Endpoint Manager, navigate to **Apps** > **By Platform** > **Android**
2. Select the **+ Add** button.
3. On the **App Type** drop-down, select **Managed Google Play app**.
4. Search for “UiPath Orchestrator”.
5. Select the app and Select **Approve**.
6. Navigate back to **Apps** > **By Platform** > **Android**. You should now see **UiPath Orchestrator** in the list of apps.
7. Select **UiPath Orchestrator** and confirm at least one group has been assigned.
8. If you want to add specific configurations, navigate to **Apps** > **App configuration policies**.
9. Select **+ Add** > **Managed Devices**.
#### Basics
1. Give your configuration a name
2. On the **Platform** field, select **Android Enterprise**,
3. On the **Targeted App** field, select the UiPath Orchestrator app.
#### Settings
1. On the **Configuration settings format** field, select **Use configuration designer**.
2. Under **Use the JSON editor to configure the disabled configuration keys.**, Select **+ Add**. When the right-side panel expands, check the **Configuration key** option, and Select **OK**.
3. From here you can check any of the configuration key options you want and Select **OK**. Please check the **Configuration Keys** section below for more info on each configuration key.
#### Assignments
1. Select which user groups you want to provide this configuration for.
#### Review + create
1. After reviewing your configuration, apply it to all users you have selected.
### IOS
1. In Intune/Endpoint Manager, navigate to **Apps** > **By Platform** > **iOS/iPadOS**
2. Select the **+ Add** button.
3. On the **App Type** drop-down, select **iOS Store app**.
4. Search for and then select “UiPath Orchestrator”.
5. The **Add App** screen is prefilled as in the following screenshot:
:::note
Make sure the minimum operating system is set to iOS 12.0.
:::
6. Select which user groups you want to provide this configuration for.
7. If you want to add specific configurations, navigate to **Apps** > **App configuration policies**.
8. Select **+ Add** > **Managed Devices**.
#### Basics
1. Give your configuration a name
2. On the **Platform** field, select **iOS/iPadOS**,
3. On the **Targeted App** field, select the UiPath Orchestrator app.
#### Settings
1. On the **Configuration settings format** field, you can select either **Use Configuration Designer or Enter XML** and add any of the supported configuration keys you’d like to. Please check the **Configuration Keys** section below for more info on each configuration key.
#### Assignments
1. Select which user groups you want to provide this configuration for.
#### Review + create
1. After reviewing your configuration, apply it to all users you have selected.
## Configuration Keys
### InstanceUrls
You can make use of this configuration key to distribute Orchestrator instance URLs to company-managed mobile devices. This saves your employees from memorizing or manually typing the web address in the Orchestrator app, which is prone to human error and generating unnecessary internal support headaches.
Through your MDM tool, URLs added to the app will appear in the app on the on-premises **Login** window.
#### VMWare Airwatch
#### **Android**
Add the on-premise instance URLs in a comma-separated list.
#### **iOS**
Fill in the instance URLs using one of the following methods:
A. Upload XML data with an `instanceUrls` string value in it. You can use comma-delimited strings if you have multiple URLs you wish to supply.
B. Add a Configuration Key with the following settings:
* **Configuration Key**: `instanceUrls`
* **Value Type**: `String`
* **Configuration Value**: A comma-delimited string of all the instance URLs
```
instanceUrls
https://my.instance.com,https://1.2.3.4
```
After the keys have been added, it should look like the following screenshot:
#### Microsoft Intune
#### **Android**
1. On the **Configuration settings format** field, select **Use configuration designer**.
2. Under **Use the JSON editor to configure the disabled configuration keys.**, Select **+ Add**. When the right-side panel expands, check the **Configuration key** option and check **On-Premise Instance URLs**, and Select **OK**.
3. Fill in the Orchestrator instance URLs as a comma-separated list as the **Configuration value** column.
#### **iOS**
Fill in the instance URLs using one of the following methods:
A. On the **Configuration settings format** field, select **Use Configuration Designer** and fill in the following:
* **Configuration Key**: `instanceUrls`
* **Value Type**: `String`
* **Configuration Value**: A comma-delimited string of all the instance URLs
B. On the **Configuration settings format** field, select **Enter XML** and fill in an XML with comma-delimited String values:
```
instanceUrls
https://my.instance.com,https://1.2.3.4
```
### DisableUserTelemetry
You can make use of this configuration key to automatically opt-out of mobile application telemetry tracking for all your employee’s devices via MDM.
#### VMWare Airwatch
#### **Android**
1. Set the **Telemetry Opt Out** field to **Enable**.
#### **iOS**
Disable telemetry using one of the following methods:
A. Upload XML data with a **disableUserTelemetry** boolean key set to **true**
```
disableUserTelemetry
```
B. Add a Configuration Key with the following settings:
* **Configuration Key**: `disableUserTelemetry`
* **Value Type**: `Boolean`
* **Configuration Value**: `true`
#### Microsoft Intune
#### **Android**
1. On the **Configuration settings format** field, select **Use configuration designer.**
2. Under **Use the JSON editor to configure the disabled configuration keys.**, Select **+ Add.** When the right-side panel expands, check the **Configuration key** option and check the **Telemetry Opt Out** option, and Select **OK**.
3. Under **Configuration value**, select the checkbox.
#### **iOS**
Disable telemetry using one of the following methods:
A. On the **Configuration settings format** field, select **Use Configuration Designer** and fill in the following:
* **Configuration Key**: `disableUserTelemetry`
* **Value Type**: `Boolean`
* **Configuration Value**: `true`
B. On the **Configuration settings format** field, select Enter XML and fill in an XML with the **disableUserTelemetry** Boolean key set to **true**:
```
disableUserTelemetry
```