Skip to content

Menus

This section provides an overview of the different MANTLE Mobile menus, each accessible from the application's top menu bar.
Select a tab below to learn more about each menu’s purpose and available features.

File → Settings

img

When you open MANTLE Mobile and go to File → Settings, you will see three important options that help configure your devices:

  1. Minimum Android Version

    • Purpose: Specifies the minimum Android OS version required for a deployment.
    • How to Use: Choose the lowest allowed Android version (e.g., Android 14) to maintain security standards. Devices running older OS versions will fail.
  2. Strict APK Version Requirement

    • Purpose: Ensures a configuration file built for a specific APK version can only run on that exact APK version (matching major versions).
    • How to Use: Enable if you have configuration files that only work with a particular APK version (e.g., 1.5.3). If the installed APK version differs, the deployment will fail.
  3. APK Auto Overwrite

    • Purpose: Allows you to overwrite an existing app version with a specified APK (older or newer). Useful for rolling back an app if a newer version has issues.
    • How to Use: Switch this on if you need to downgrade or upgrade an APK.

Example Scenarios

  • Minimum Android Version:
    If your organization mandates Android 14 for compliance, set it here.
  • Strict APK Version Requirement:
    If your config files only support version 1.5.3, enable this to prevent mismatched installations.
  • APK Auto Overwrite:
    If you must roll back from 1.5.0 to 1.4.2 due to a security flaw, enable this to override the existing version.

Console

img

The MANTLE Mobile Console is your real-time log viewer, found to the right of the main gui. It’s crucial for monitoring deployments and catching errors.

  • Log Display: Lists all messages (info, errors, warnings) in one place.
  • Error Tracking: Instantly flags any issues for quick troubleshooting.
  • Task Monitoring: Shows the current actions each device is performing.

Device Log Filtering

By default, the Console will only display [System] and [Error] logs.
When a provision is in progress, a field with "Click Device Checkbos to Toggle Logs" will appear below the main gui.
Checking a device here will add logs pertaining to the checked device to the console. This can be helpful when a device has an issue, allowing for you to troubleshoot the logs for only the selected device(s).
Issues are indicated by the following status lights:
img Warning: 15 attempts have been made to find a view unsuccessfully for this device. This may indicate a pop-up is obscuring the intended view.
img Failure: This device failed to provision successfully. View its logs to troubleshoot.

img

Tools → Show Tools

img

MANTLE Mobile Tools provides various utilities to streamline device management and maintenance:

  • Generate: Creates screen data in a config-file-friendly format.
  • Uninstall: Removes specific apps (those known to MANTLE Mobile’s database).
  • Uninstall All: Wipes all third-party apps from connected devices.
  • Screen On/Off: Toggles device displays.
  • Reboot: Restarts connected devices.
  • Shutdown: Powers off connected devices.
  • Factory Reset: Resets devices to factory defaults (if not blocked by policy).
  • Clear Certificates: Removes CA certificates, ensuring a fresh security state.

Tools → Device Management

img

The Device Management window keeps a record of devices in an encrypted database—essential for deployments and other operations.

  • Add New Device: Manually add device info (UUID, serial, OS, PIN, custom variables, etc.).
  • Edit Selected Device: Modify existing details for a device.
  • Delete Selected Device: Remove a device from the database (irreversible).
  • Import Connected Devices: Pulls data from authorized, physically connected devices (UUID, Serial, model, OS, etc.).
    • Note: This can be used to fill in missing information from an imported spreadsheet. (An imported spreadsheet with only Serial Numbers will be filled in with UUIDs and other device information.)
  • Import Spreadsheet: Bulk-import device info from a properly formatted Excel spreadsheet (including custom variables).
  • Export To Spreadsheet: Exports all device data to an Excel spreadsheet for backup or external management.
  • Delete All Devices: Clears the entire database (irreversible).
  • Show Custom Vars: Displays or edits custom variables for each device.

Tools → Deployment Management

img

Deployment Management allows you to create and manage app deployments at a per-device level:

Note: Each device will deploy with APKs and Configuration Files that are specific to them.

  • Add New Deployment: Define which apps/configs go on each device for granular control.
  • Delete Selected Deployment: Removes a single deployment configuration (irreversible).
  • Delete All Deployments: Clears all deployment configurations from the database.
  • Start Custom Deployment: Launches the specified deployment on connected devices.

Tools → Configuration Manager

img

Configuration Manager allows for the creation, editing and validation of Configuration Files:

  • Edit Selected Configuration File: You can edit Configurations by selecting a file you would like to edit and clicking Edit Selected Configuration File. (See Editing Configuration Files).
  • Record New Configuration File: Starts the Record feature. (See Recording).
  • Validate Configuration Files: This button is used to ensure there are no errors within all imported Configuration Files.

Tools → Baseline Manager

img

Baseline Manager helps you edit and create JSON-based baseline files for consistent, large-scale installations:

  • To create a new Baseline File and click Create New Baseline File.
  • To edit select an existing Baseline File and click Edit Selected Baseline File.
  • Both options will open the following window. If editing, the values will be pre-populated with the options configured for the selected Baseline File.

img

  • Device Management Pin: Toggle that determines if this Baseline will utilize a global pin for all devices or the pin specified for each device within Device Management.
  • Edit Prep Settings: This button will take you to the Prep Management screen to allow for configuring device settings to be applied when executing this baseline. (See Prep Management)
  • Select APKs: Choose APKs you would like to install for this Baseline (the order they are added is the order they will be installed).
    • If connected to Workspace ONE, you can toggle Local to Airwatch to select APKs that are available via Workspace ONE. (See Workspace ONE Deployments)
  • Select Configuration Files: Select the Configuration Files to be executed for this Baseline (the order they are added is the order they will be executed).
  • Generate Baseline: Generates a Baseline File that can be used to execute a Baseline Deployment.

Tools → Prep Manager

img

Prep Manager enables you to specify Android OS-level settings to apply to devices prior to a deployment, such as:

Display Settings
  • Edge Panels: Toggles the Android Edge Panels feature to display applications by swiping on the right edge of the screen. Options: On or Off.
  • Motion Smoothness: Toggles the Android refresh rate options. Options: Standard or Adaptive.
  • Screen Timeout: How long before the screen will turn off for inactivity. Options: 15 seconds - 10 minutes. Note: This is set to 10 minutes during a deployment, but will revert to the user specified setting upon completion.
  • Auto Rotate: Toggles the automatic transition from Portrait to Landscape. Options: Enable or Disable. Note: This is Disabled during a deployment, but will revert to the user specified setting upon completion.
  • Accidental Touch: Prevents screen activation when screen is covered. Options: Enable or Disable. Note: This is Disabled during a deployment, but will revert to the user specified setting upon completion.
  • Dark Mode: Toggles Dark Mode.
  • Circle to Search: Setting to search device content by holding the Home button. Note: This may prevent some pop-ups for more reliable deployments.
  • Widget Removal: Removes widgets from the device home screens. Widgets: Weather, Google Searchbar, Galaxy Store, Play Store, Google Folder, Onedrive.
Connection Settings
  • Bluetooth: Toggles Bluetooth. Options: Enable or Disable.
  • Wifi: Toggles Wifi. Options: Enable or Disable.
  • Connect to Wifi: Connect to a specified Wifi network. Settings: Wifi SSID, Wifi Password, and Network Gateway.
  • NFC and Contactless Payment: Toggles Android Near Field Communication features. Options: Enable or Disable.
  • Nearby Device Scanning: Toggles Nearby Device Scanning features. Options: Enable or Disable.
  • Default Print Service: Toggles Default Print Service features. Options: On or Off.
Application Settings
  • Battery Optimization: Configure the Battery Optimization settings for selected APKs. Options: Unrestricted or Optimized.
Security Settings
  • Autofill: Toggle Android feature to automatically suggest usernames and passwords when typing within textfields. Options: Enable or Disable.
  • USB Debugging: Toggle debugging features via USB. Note: If set to disable, this setting will apply following a deployment as USB Debugging is required for Mantle Mobile.
  • Block USB While Locked: Toggle feature to prevents USB connections while devices are locked. Options: Enable or Disable.
  • Delete Sensitive Files: Following a deployment, this feature will delete all .crt and .ovpn files within the #Hold and #unique folders that were transfered to devices during a deployment.
File Settings
  • Delete TMP Folder: Adds task to delete the .tmp folder.
  • Delete ATAK Folder: Adds task to delete the atak folders that exist on the devices prior to deployment.
  • Transfer ATAK Folder: Adds task to transfer the selected ATAK Prefs file to devices. This will send the selected file as the defaults preferences file used for ATAK configuration. These files can be configured within Tools → File Manager.
  • Import Cert: Adds task to Install certification files that were transfered to the devices within the #Hold folder.
Advanced Settings
  • Video Call Effects: Toggles feature to configure effects such as backgrounds colors for video calls. Options: Enable or Disable.
  • Game Launcher: Toggles Samsung Game Launcher application. Options: Enable or Disable.
  • Bixby: Enable or Disable Bixby features. To fully disable Bixby, ensure "Service", "Agent", and "Wakeup" features are disabled. Options: Enable or Disable.
  • Quick Menu Removal: Removes specified buttons from the Samsung Quick Menu. Available to Remove: Quick Share, Nearby Share, Scan QR Code, Dolby Atmos, Smart View.

Purpose

The Prep Management menu in MANTLE Mobile enables you to specify non-application specific tasks to occur prior to or following a deployment. This functionality is useful for configuring WiFi connections, ensuring security, and standardizing Android OS settings accross all devices.


Tools → File Manager

img

Importing Assets File Manager enables you to import assets (e.g., APKs, Configuration FIles, Baseline Files, ATAK Files, Common Files, and Unique Files) required for deployments:

  1. Open File Manager: Tools → File Manager.
  2. Select Asset Type: Identify if it’s an APK, config file, cert, etc.
  3. Browse for Files: Find them on your local system.
  4. Import Assets: Make them available in MANTLE Mobile’s database.

Device Options In the Device Options section of the File Manager, you can:

  1. Install selected APKs onto all connected devices that exist within Device Management.
  2. Push Selected Common Files to /storage/self/primary/#Hold within all connected devices that exist within Device Management.
  3. Push Selected Unique Files to /storage/self/primary/#unique to within their cooresponding devices configured within the Device Management Files column.

ATAK Pref Editor You can edit ATAK pref files that have been imported by selecting a Pref File and clicking "Edit Pref". img From here you can configure what settings and plugins you would like ATAK to be launched with. To apply these settings, this file must be selected when applying the Transfer ATAK Folder setting within Prep Management.

MANTLE Mobile integrates with external platforms like Mantle Enterprise or Workspace ONE.

Enterprise Management

  • Access: Integrations → Enterprise Management
  • Purpose: The MANTLE Mobile Enterprise Management Menu allows for the management of Mantle Mobile's connection to Mantle Enterprise..

img

Registering with Mantle Enterprise.
  1. Import Enterprise Token: Clicking Import Enterprise Token will allow for you to browse for an Enterprise Token to import. (See Mantle Enterprise: Registering a Node on how to generate an Enterprise Token.)
  2. Register With Enterprise: Once an Enterprise Token has been imported (Indicated when the Token table is populated with the correct URL and Group ID), you can click Register With Enterprise. This will reach out to Mantle Enterprise with the information from the imported token and register. Successful registration is indicated by the Registration Status table being populated with a Node ID and a Registered timestamp.
Unregistering from Mantle Enterprise.

To unregister from Mantle Enterprise, click the Delete Token and Unregister button. This will reach out to Mantle Enterprise to unregister this node and delete the local Enterprise Token.

Downloading Assets from Mantle Enterprise.

Asset management takes place within the Assets tab.

  1. Check For Missing Assets: Clicking Check For Missing Assets will reach out to the Mantle Enterprise group your node is registered with and check for assets that are assigned to this group. The "All Missing Assets" table will be populated with assets that Mantle Mobile is missing. You can sort this table with the Asset Type checkboxes.
  2. Downloading Assets:
    • To download all missing assets, you can click Download All Missing Assets below the "All Missing Assets" table.
    • To choose and download specific assets, you can click on the desired assets in the "All Missing Assets" table and click Add To Selected. This will populate the "Selected Assets" table. You can then click the Download Selected Assets button to only download the selected assets.
Syncing Devices With Mantle Enterprise.
  • Device management takes place within the Devices tab.
    img
    • Populate Local Device Table: The Check For Missing Assets button will display the devices within the local Mantle Mobile database and whether or not they are currently connected.
    • Sync Devices To Enterprise: The Sync Devices To Enterprise button will advertise all devices that are currently connected and within the local database to Mantle Enterprise and add them to the node's group. This will add all information displayed within Device Management to your Mantle Enterprise group. Note: Ensure devices you want to add to your Mantle Enterprise group have a "Connection Status" of "Connected".
    • Sync Devices From Enterprise: The Sync Devices From Enterprise button will retrieve all devices within your Mantle Enterprise group and add them to your local Mantle Mobile database. They will then be visible within Device Management.
Executing Mantle Enterprise Deployments.
  • Note: Prior to executing a deployment via Mantle Enterprise, a "Provision" must first be created on Mantle Enterprise within your group's "Provision" tab. (See Mantle Enterprise: Provisioning)
    • Check Enterprise Queue And Deploy: To manually execute a deployment via an active Provision from Mantle Enterprise, the Check Enterprise Queue And Deploy button can be used. This will reach out to Mantle Enterprise, check for any missing assets, download them, check for an Active Provision, and deploy the Baseline specified in this Provision.

Toggle Enterprise Connection.

  • Note: This will make your the Mantle Enterprise Group you are currently registered with the Sole Source of Truth. Your local "Device Management" table will be overwritten with the device information for your Mantle Enterprise Group. It will automatically download any missing assets. Use with Caution.
  • To toggle this feature, click Integrations → Toggle Enterprise Connection. Once toggled, the following steps will take place:
    • Mantle Mobile will overwrite the local "Device Management" table with device information retrieved from the Mantle Enterprise Group it is registered with.
    • Mantle Mobile will check for assets that are assigned to the Group it is registered with and download any that it is missing locally.
    • Mantle Mobile will check for any Provisions that are currently active within it's Mantle Enterprise Group.
    • If there is an active provision that applies to any locally connected devices, it will execute any of the Active Provisions' specified Baselines onto these provisions' specified devices.
    • During a deployment, Mantle Mobile will pause it's connection with Mantle Enterprise.
    • Following the deployment, this process will repeat until Enterprise Connection is toggled off or a failure occurs.

API Credential Manager img

  • Access: Integrations → API Credentials
  • Purpose: Configure connections (URL, tokens, tenant codes) to external APIs (e.g., AirWatch/Workspace ONE).

Toggle AirWatch API - Access: Integrations → Toggle Airwatch API Connection
- Purpose: Enable/disable the current active API from the Credential Manager.

Tabs in MANTLE Mobile

MANTLE Mobile features two main tabs by default:

  1. Home
    img

    • Provision (Ad-Hoc): Installs chosen apps/configs on connected devices.
    • Record: Records user actions to build a Configuration File.
    • Start Server: Lists connected devices in the console.
    • Stop Install: Cancels an ongoing deployment and closes MANTLE Mobile.
  2. Baseline
    img

    • Baseline Deployments: Displayes the available baseline files (created via Baseline Manager and imported via File Manager).
    • Deploy Selected Baseline: Execute the selected baseline to all connected devices that are configured within Device Management.