Skip to main content
Cisco Meraki Documentation

Installing Custom Apps on iOS and Android Devices

iOS Custom (Enterprise) Apps

Systems Manager allows for the distribution of enterprise iOS apps that are developed in-house and the organization needs are not met by the public/private Apple app store release channel. Enterprise iOS apps are apps developed using the iOS Enterprise Developer Program. This program allows for development of internally created iOS apps. To deploy these in-house enterprise apps over-the-air to managed iOS clients, Systems Manager will distribute a manifest file (.plist) to devices during app installation.

  • Only in-house developed applications should be used with this process. Applications developed by any third party should only be accessed using the public Apple app store or Apple Business Manager custom/private app process. 
  • The enterprise app should be packaged using the over-the-air (OTA) method.
  • The enterprise app should be signed using a valid Enterprise distribution certificate.

Installing Custom (Enterprise) iOS Apps

Begin by navigating to Systems Manager > Apps > Add App > iOS > Custom (Enterprise) app. Systems Manager allows for three methods of Enterprise iOS app deployment: 

  • Specify a link to an externally hosted manifest .plist file.
  • Host the manifest .plist file within Systems Manager.
  • Host the .ipa file within Systems Manager. Dashboard will generate, host, and push a manifest .plist file.

For more information on distribution of custom enterprise applications, reference Apple's Distribute proprietary in-house apps to Apple devices documentation.

Specify a link to an externally hosted manifest .plist file

  1. Navigate to Systems Manager > Apps > Add App > iOS > Custom (Enterprise) app.
  2. Within the Source section drop-down, choose "Specify a manifest URL".
  3. Provide a link to an externally hosted .plist  file. This link must be accessible by dashboard and targeted devices.
  4. Select a tag group to deploy the app to from the "Scope" field (please consult this Knowledge Base article for information on creating and assigning Tags). 
  5. Save Changes and allow 1 - 2 minutes for changes to take effect.

Screenshot 2024-03-27 at 2.01.22 PM.png

 

  • When a device with the same tag next checks-in with Systems Manager, the iOS device user will be prompted to install the app. The user will not need to input an Apple ID or password to download the application.
  • The app can be updated by first replacing the .plist and .ipa files on the remote server, and then use the select dropdown to select out of date entries then use the push dropdown to trigger an install or update command. The .plist file must contain a link to an updated .ipa file. If the .plist or .ipa file have changed locations, update their links where required.

Host the manifest .plist file within Systems Manager

  1. Navigate to Systems Manager > Apps > Add App > iOS > Custom (Enterprise) app.
  2. Within the Source section drop-down, choose "Upload a manifest plist".
  3. Upload a manifest.plist  file.
  4. Select a tag group to deploy the app to from the "Scope" field (please consult this Knowledge Base article for information on creating and assigning Tags). 
  5. Save Changes and allow 1 - 2 minutes for changes to take effect.

Screenshot 2024-03-27 at 2.12.24 PM.png

  • When a device with the same tag next checks-in with Systems Manager, the iOS device user will be prompted to install the app. The user will not need to input an Apple ID or password to download the application.
  • The app can be updated by first replacing the .ipa file on the remote server, use the select dropdown to select out of date entries then use the push dropdown to trigger an install or update command. If the URL hosting the .ipa file has changed, update the manifest .plist file and upload the new manifest .plist file to dashboard. 

Host the .ipa file in Systems Manager

  1. Navigate to Systems Manager > Apps > Add App > iOS > Custom (Enterprise) app.
  2. Within the Source section drop-down, choose "Upload an IPA".
  3. Upload a .ipa file.
  4. Select a tag group to deploy the app to from the "Scope" field (please consult this Knowledge Base article for information on creating and assigning Tags).
  5. Save Changes and allow 1 - 2 minutes for changes to take effect.

Screenshot 2024-03-27 at 2.17.14 PM.png

  • When a device with the same tag next checks-in with Systems Manager, the iOS device user will be prompted to install the app. The user will not need to input an Apple ID or password to download the application.
  • The app can be updated by first replacing the .ipa file on dashboard, then use the select dropdown to select out of date entries then use the push dropdown to trigger an install or update command.

Android Custom Apps

Applications can be pushed silently to all Android devices in both BYOD and Device Owner mode for Google Play Store apps.
To install a custom .apk silently, upload the .apk to Google's managed Play for Work Store as a private (or public) app and push it as a Google Play Store application in Systems Manager. For more information view how to manage private Android apps in Google Play

Installing Custom Android Apps

To upload custom .apk files to the managed Play Store for silent deployment please follow this Google article. Afterwards your account should be able to add that app name/identifier to the Systems Manager Apps page as a Store app. 

Additionally, there is the option to distribute the .apk file directly through the Meraki Dashboard. In Systems manager > Manage > Apps, click Add new > Android > Custom app. Fill in the fields as desired and either link to a URL where your .apk is hosted, or upload it directly to the Meraki Cloud.

See this article for information on app configuration settings.

add_android_app.png

Note: With custom uploaded .apk apps, end users may need to accept an additional prompt (e.g. "Do you want to install this application?"). The ability to install apps may also require devices to allow unknown sources, which can be enabled from a SM profile or manually on device by enabling developer mode. To avoid these constraints, the recommendation for modern Android (11+) is to use the Google Play Store private or public app method, as this is the supported method per Google. Using this method the apps can be pushed as Google Play Store apps via SM and install silently. 

 

  • Was this article helpful?