Docs

Integrations / Devices / SimpleMDM

Push Assigned Apps and Media

Installs all assigned apps and media to a SimpleMDM device

Sends a remote command to install all apps and media assigned to a device but not yet installed. The device must be online and unlocked for installation to occur.

Overview

This tool triggers SimpleMDM to push all apps assigned to a device through assignment groups, profiles, or direct assignments. Installation happens silently in the background for managed apps. Installation time varies based on app size and network speed.

Setup

Use the same API key setup as other SimpleMDM tools:

  1. Navigate to Settings > API in SimpleMDM
  2. Create or use existing API key
  3. In Risotto, select Tools in the sidebar, then select SimpleMDM in the Tool groups list
  4. Find SimpleMDM Push Assigned Apps and Media, click Set up, and enter your key in Api Key
  5. Click Save

Usage

Push all assigned apps:

"Push assigned apps to SimpleMDM device 12345"

Common workflow:

1. Find device: "Find SimpleMDM device for john@company.com"
2. Check current apps: "Get device info for device 12345 with include_apps=true"
3. Push apps: "Push assigned apps to device 12345"
4. Wait 5-15 minutes for installation
5. Refresh inventory: "Refresh inventory for device 12345"
6. Verify installation: "Get device info for device 12345, search for Slack"

Configuration Options

Required:

  • device_id - Device ID from SimpleMDM Find User Device

How It Works

  1. Tool sends InstallApplication MDM command for all assigned apps
  2. SimpleMDM queues commands for each uninstalled app
  3. Device receives commands when online and unlocked
  4. Apps download and install automatically
  5. Device reports installation status back to SimpleMDM

Installation timeline:

  • Small apps (< 50 MB): 2-5 minutes
  • Medium apps (50-500 MB): 5-15 minutes
  • Large apps (> 500 MB): 15-30+ minutes
  • Multiple apps: Install concurrently, longest app determines completion time

Response Format

Returns a success message:

Push assigned apps command sent successfully to device 12345.
Apps will begin installing on the device within the next few minutes.
Installation time depends on app sizes and network speed.
Device must be online and unlocked for installation to complete.

Device Requirements

For successful installation:

  • Device must be online with internet connection
  • Device must be unlocked (macOS: logged in, iOS/iPadOS: not locked)
  • Device must have sufficient storage space
  • Device must be enrolled and responsive to MDM commands

Supported devices:

  • macOS 10.10+ (Yosemite or later)
  • iOS 7.0+ (all versions)
  • iPadOS 13.0+ (all versions)
  • tvOS 9.0+ (all versions)

What Gets Pushed

SimpleMDM will attempt to install:

  • Apps assigned via assignment groups
  • Apps directly assigned to the device
  • Apps included in applied profiles
  • Media files assigned to the device (books, documents, etc.)

Not pushed:

  • Apps already installed on device
  • Apps not assigned to the device
  • Apps user previously rejected (may require manual installation)

Assignment Groups

Apps must be assigned to devices in SimpleMDM:

  1. In SimpleMDM, go to Apps
  2. Select an app
  3. Click Assignments
  4. Add assignment groups, devices, or users
  5. Save assignments

Alternatively, use device groups and automatic assignment rules.

Troubleshooting

Apps not installing:

  • Verify apps are assigned to device in SimpleMDM
  • Check device is online and unlocked
  • Ensure sufficient storage space (Settings > Storage)
  • Verify device is not in lost mode
  • Wait longer (large apps take time)
  • Check network connection quality

Installation fails:

  • App may require user consent (non-VPP apps)
  • App may not be compatible with device/OS version
  • Storage space may be insufficient
  • Network connection may be poor
  • Check SimpleMDM logs for specific errors

Some apps install, others don't:

  • Check individual app requirements
  • Verify all apps are compatible with device OS
  • Some apps may require specific device features
  • Review SimpleMDM app assignment errors

Command succeeds but nothing happens:

  • Device may be offline
  • Device may be locked
  • Check device last_seen_at timestamp
  • Verify device enrollment status

When to Use

Good use cases:

  • Onboarding new devices
  • User requests app installation
  • Restoring apps after device wipe
  • Troubleshooting missing apps
  • After assigning new apps to device

Not necessary for:

  • SimpleMDM automatically pushes apps on enrollment
  • Automatic installation policies handle most cases
  • Apps may already be installed

Installation Status

Check installation progress:

  1. Wait 5-15 minutes after pushing apps
  2. Refresh device inventory: Use Refresh Device Inventory tool
  3. Get updated app list: Use Get Device Information with include_apps=true
  4. Check for newly installed apps with managed=true

Rate Limiting

  • Avoid pushing apps repeatedly to same device
  • Wait for previous installations to complete
  • SimpleMDM may limit command frequency per device

Network Considerations

Installation speed factors:

  • Network bandwidth (WiFi vs cellular)
  • App file sizes
  • Number of apps being installed
  • SimpleMDM CDN performance
  • Device processing power

Best practices:

  • Push apps when device is on reliable WiFi
  • Consider staging large app deployments
  • Schedule bulk pushes during off-hours
  • Monitor installation progress

Security Notes

  • Requires API key with app management permissions
  • Apps are installed via authenticated MDM commands
  • VPP apps use encrypted licenses
  • Silent installation for managed apps (no user interaction)
  • App installation is logged in SimpleMDM
  • SimpleMDM Find User Device - Get device_id to use with this tool
  • SimpleMDM Get Device Information - Check which apps are already installed
  • SimpleMDM Refresh Device Inventory - Update inventory after installation to verify

Something wrong or missing? Report an issue · View as Markdown