# Install the Cerby mobile app for Android via an MDM platform

With Cerby, you can centrally deploy the Android mobile app across your organization’s managed devices and preconfigure allowed workspaces during installation, using **Managed Google Play** and a Mobile Device Management (MDM) solution such as Jamf Pro or Microsoft Intune.

{% hint style="danger" %}
**IMPORTANT:** Cerby suggests always using the latest version of the Cerby mobile app to perform this configuration.
{% endhint %}

***

## Requirements

The following are the requirements to configure and install de Cerby mobile app on Android:

* **Managed Google Play:** The Cerby app must be added and approved in your Android management console.
* **Android Enterprise enrollment:** Devices must be enrolled in Fully Managed, Dedicated, or Corporate-Owned Work Profile mode.

***

## Install the Cerby mobile app for Android via an MDM service

The following are the configurations you can use to install the Cerby mobile app for Android via an MDM service:

* [Configuration for Jamf Pro](#configuration-for-jamf-pro)
* [Configuration for Microsoft Intune](#configuration-for-microsoft-intune)

### Configuration for Jamf Pro

To add, configure, and deploy the Cerby mobile app for Android, you must complete the following steps:

1. Add the Cerby mobile app by following the next steps:
   1. Log in to your [Jamf Pro](https://www.jamf.com/login/) account on a browser window.
   2. Click the **Devices** <img src="https://downloads.intercomcdn.com/i/o/pc0ldyqu/2010864602/0e60bc86d6d9a36c8db01ec298ad/51ed38c3-2242-45b0-a7ef-5e0f08b14918?expires=1769904000&#x26;signature=a32a6a01a56577b81eaf7b03590a1a595706b6edc4c0872ff1082ea88f3f34f8&#x26;req=diAmFsF4mYdfW%2FMW3Hu4gRYDNC131q%2BQ8RnJrI0BNsxaSyI%2FBtYCEUM6QEqr%0AQA%3D%3D%0A" alt="" data-size="line"> button in the top navigation bar.
   3. Select the **Mobile Device Apps** <img src="https://downloads.intercomcdn.com/i/o/pc0ldyqu/2010866376/7dae877f6d36d3a2730b01798cd7/4d62c722-2fd5-4694-88e5-a710e5cb6672?expires=1769904000&#x26;signature=0db7a6874df120fe459f4ca27a7959009a8db34e8c061eb53a21bae118969ae3&#x26;req=diAmFsF4m4JYX%2FMW3Hu4gbzA68ZKq4jFbLlOKR87bzzqQbBfBNWMi8qp1qq%2F%0AAw%3D%3D%0A" alt="" data-size="line"> option from the **CONTENT MANAGEMENT** section in the left navigation drawer. The **Mobile Device Apps** page is displayed.
2. Create a new mobile app configuration profile by following the next steps:
   1. Click the **New** <img src="https://downloads.intercomcdn.com/i/o/pc0ldyqu/2010868089/012395f4e91278d923b32d42c309/a57f31b1-6faf-4755-bdf3-c0386153974e?expires=1769904000&#x26;signature=833ca001d9bbb09ad0253ee7f0b89e594624b7c369a409d34416c82bd553f9d1&#x26;req=diAmFsF4lYFXUPMW3Hu4gZAJL7J15ckIX9%2FLAt0p%2FUWsQuQN7x4OYbdPotzD%0Aww%3D%3D%0A" alt="" data-size="line"> button. The **General** section is displayed on the **Choose an App** page.
   2. Select the **App Store app or apps purchased in volume** option.
   3. Click the **Next** button.
   4. Enter “Cerby” in the search field.
   5. Click the **Next** button.
   6. Click the **Add** button next to the Cerby item.
3. Configure the app settings by following the next steps:
   1. Select the **App Configuration** option.
   2. Select the configuration you want to use:

      * **Using the JSON format**

        1. Select the **Enter JSON** option.
        2. Paste the following snippet:

        ```json
        {
            "allowedWorkspaces": ["workspace1", "workspace2", "workspace3"]
        }
        ```
      * **Using the XML format**

        1. Paste the following XML snippet into the **Property List** field:

        ```xml
            <plist version="1.0"><dict>
            <key>com.cerby.managed.workspaces</key>
            <string>workspace1, workspace2</string>
            </dict>
        ```

      **NOTE:** Cerby supports up to five workspaces. If more are added, only the first five are used.
   3. Click the **Save** button.
4. Set the scope by following the next steps:
   1. Select the **Scope** tab to add your deployment targets.
   2. Add your target devices or user groups. For more information, read the [Scope](https://learn.jamf.com/bundle/jamf-pro-documentation-current/page/Scope.html) official documentation.
   3. Click the **Save** button.

Now you are done.

### Configuration for Microsoft Intune

Microsoft Intune uses App Configuration Policies to deliver managed app settings through Managed Google Play. To create, configure, and assign an App Configuration Policy for the Cerby mobile app, complete the following steps:

1. Create the policy by following the next steps:
   1. Select the **Apps** menu item.
   2. Select the **App configuration policies** menu item.
   3. Click the **Add** button.
   4. Select the **Managed devices** option.
   5. Select the **Android Enterprise** platform option.
   6. Select the appropriate **Profile Type** option.
   7. Select the **Cerby** application option.
2. Configure the corresponding settings by following any of the following options:
   * **Using the Configuration Designer**
     1. Select the **Use configuration designer** option.
     2. Click the **Add** button.
     3. Select the **allowedWorkspaces** key option.
     4. Enter the workspace values in the **Value** field.
   * **Using a JSON snippet**

     1. Select **Enter JSON data** option.
     2. Enter the configuration structure in the **JSON data** field:

     ```json
     {
         "kind": "androidenterprise#managedConfiguration",
         "productId": "app_package_name",
         "managedProperty": [
         {
             "key": "allowedWorkspaces",
             "valueString": "workspace1, workspace2"
         }
         ]
     }
     ```
3. Assign the policy by following any of the following options:
   1. Select the **Assignments** tab.
   2. Select the appropriate user or device group option.
   3. Click the **Create** button.

Now you are done.


---

# 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://help.cerby.com/setup-and-admin/client-app-deployment/install-the-cerby-mobile-app-for-android-via-an-mdm-service-and-configuration-files.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.
