Skip to content

Getting Started with Mantle Mobile

Follow these steps to install the desktop app, unlock the encrypted database, and verify licensing before you begin recording configs or provisioning devices.

System Requirements

  • Windows 10/11, Debian-based Linux, or RHEL-based Linux workstation
  • USB connectivity for all targeted Android devices
  • Android devices with USB debugging enabled (Settings > Developer Options)

Install or Update the Application

Platform Package
Windows 10/11 MantleMobileSetup_x64_v2.0.0.exe
Debian derivatives MantleMobile-v2.0.0-amd64.deb
RHEL derivatives MantleMobile-v2.0.0-x86_64.rpm

Install the package using the platform’s native installer. Upgrades can be performed by running the newer package over the existing installation.

First Launch and Database Key

  1. Launch Mantle Mobile.
  2. When prompted, create and confirm the database encryption key.
  3. Store this key securely—there is no recovery path if it is lost.
  4. The app initializes the encrypted database and opens the login screen.

Create Encryption Key

Encryption key

Losing the key requires rebuilding the database from scratch. Store it alongside other credential material.

Unlock the Session

Enter the encryption key each time you launch the app to unlock the database.

Encryption key prompt

Upload a License

  1. Go to Settings > Licenses or select Upload a valid license in the bottom left.
  2. Select the plus button.
  3. Choose the .yml file provided by your program office.
  4. Confirm that the license was imported and the license status badge shows Valid.

License upload workflow

Add license button

Successful import

Valid license

Without a license you can only record configs and baselines; provisioning and enterprise features remain disabled. ;Token count is 2.

Device Setup

In order to connect a device to MANTLE Mobile, it must be in Developer Mode with USB Debugging enabled.

  1. On the device, open the settings menu by swiping from the top and tapping the settings cog icon.
  2. Scroll or search for and touch About Phone.
  3. Touch Software information.
  4. Tap Build number 5 times. You may be prompted to enter your pin. If successful, you will see the pop-up Developer mode has been turned on..
  5. You can now search for and access usb debugging.
  6. Toggle it on.

Device settings

About phone

Software info

Build number

Usb debug

Toggle on

Verify the Environment

After licensing and device setup, complete the following quick checks:

  • Connect a test Android device. Confirm it appears under Connected Devices.
  • Navigate to Assets > APKs and import at least one package to verify file access.
  • Open Create > Create Config to ensure the recording wizard launches.

If any check fails, review Troubleshooting before proceeding.

Next Steps

  1. Explore the UI in detail via Menus and GUI.
  2. Satisfy the Prerequisites required for recording.
  3. Record your first configuration file (See: Build a Configuration File) and build a baseline (See: Build a Baseline File).
  4. Run a local Provision and optionally register with Mantle 2.