Configure Jump Desktop for iOS and iPadOS with MDM#

Managed app configuration is the MDM mechanism for delivering settings and predefined computers to Jump Desktop on iPhone and iPad. For example, you can lock settings, prevent users from saving credentials, or deploy the same computer list to every managed device. Jump Desktop for Android does not support managed app configuration.

Deliver the configuration#

In your MDM, add an app configuration for Jump Desktop. The bundle ID is 4GU63N96WE.com.p5sys.jumpdesktop.
Add the keys from the following tables. Key names are case-sensitive.
Assign the configuration to your devices.

A key you set overrides the user's choice while the configuration is installed. Keys you omit retain the user's value or the default.

Example#

This configuration locks settings, blocks saved credentials and VNC, and locks the app after 60 seconds in the background:

<dict>
  <key>SettingsLock</key>
  <true/>
  <key>SettingsLockPassword</key>
  <string>Example-Passw0rd</string>
  <key>AllowCredSaving</key>
  <false/>
  <key>disableVNC</key>
  <true/>
  <key>ShowLockScreen</key>
  <true/>
  <key>ShowLockScreenAfterSeconds</key>
  <integer>60</integer>
</dict>

Security and computer list keys#

Key	Type	Default	Description
`SettingsLock`	Boolean	`false`	Require a password to open settings. Takes effect at the next launch. Always set `SettingsLockPassword` as well; otherwise, settings cannot be unlocked.
`SettingsLockPassword`	String	None	Password for `SettingsLock`.
`ShowLockScreen`	Boolean	`false`	Lock the app when the user leaves it. The user unlocks the app with Face ID, Touch ID, or the device passcode. Has no effect on devices without a passcode.
`ShowLockScreenAfterSeconds`	Integer	`300`	Seconds in the background before `ShowLockScreen` locks the app.
`AllowCredSaving`	Boolean	`true`	`false` hides the option to save credentials when signing in.
`DefaultConnectionPassword`	String	None	Password used when a computer has no saved password.
`disableSendPassword`	Boolean	`false`	`true` disables the Password menu item that types the saved password on the host during a session.
`disableVNC`	Boolean	`false`	Hide VNC computers and the option to add VNC connections.
`UseKeychainSyncing`	Boolean	`true`	Sync saved credentials through iCloud Keychain. Takes effect at the next launch.
`servers`	Array of strings	None	Predefined computers, one `.jump` JSON document per string. See Predefine computers.
`server1`, `server2`, ... `serverN`	String	None	Alternative to `servers`, with one `.jump` document per key. Number the keys from 1 without gaps; reading stops at the first missing number.

Session and display keys#

Key	Type	Default	Description
`AutoHideToolbarOnConnect`	Boolean	`true`	Hide the toolbar when a session connects.
`autoReconnectEnabled`	Boolean	`true`	Auto Reconnect.
`idleTimerEnabled`	Boolean	`false`	`false` prevents the device from sleeping or auto-locking during a session (Disable Sleep on).
`ZoomOutFullyOnConnect`	Boolean	`true`	Start Zoomed Out: show the entire host screen on connect.
`AlignScreenToTop`	Boolean	`false`	Align Screen To Top.
`ShowConnectAnimation`	Boolean	`true`	Show Connection Animation.
`keyboardPopupButtonHidden`	Boolean	`false`	Hide the on-screen keyboard button in sessions.
`rdpInitialNumLockState`	Boolean	`false`	Turn on Num Lock on the host after connecting. RDP only.
`ProjectorEnabled`	Boolean	`true` on iPhone, `false` on iPad	Use External Display: show the session on a connected external display.
`ProjectorUseOverscan`	Boolean	`true`	Compensate for overscan on an external display.
`stickyZoomEnabled`	Boolean	`false`	Sticky Zoom: temporarily lock zooming at 1:1.
`toolbarHiddenOnMenuBarDevices`	Boolean	`false`	`true` turns off Show Toolbar. iPad with iPadOS 26 or later only.

Keyboard, mouse, and touch keys#

Key	Type	Default	Description
`addHardwareKeyboardMappings`	Boolean	`true`	Add Jump Desktop's shortcuts and mappings for physical keyboards.
`mapHardwareKeyboardLeftAltToRightAlt`	Boolean	`false`	Send the left Alt key on a physical keyboard as right Alt.
`mapHardwareLeftAltToNull`	Boolean	`false`	Ignore the left Alt key on a physical keyboard.
`reverseScrollDirection`	Boolean	`false`	Reverse Scroll Direction for the scroll gesture.
`InvertTrackpadMode`	Boolean	`false`	Reverse Trackpad Gestures.
`ForceTouchForRightClick`	Boolean	`true`	3D Touch: press firmly to right-click, on supported devices.
`UseHapticFeedback`	Boolean	`true`	Haptic Feedback for the right-click gesture.
`UseInertialHover`	Boolean	`true`	Pointer Inertia in trackpad mode.
`PredictivePencilTap`	Boolean	`true`	Predictive Pencil Tap: make Apple Pencil double-taps easier.
`PhysicalMouseEnabled`	Boolean	`true`	Connect To Mouse for supported Bluetooth mice (see jumpdesktop.com/mice).
`PhysicalMouseAcceleration`	Boolean	`true`	Pointer Acceleration for supported Bluetooth mice.
`PhysicalMouseLockPointerKey`	Boolean	`false`	Lock Mouse Pointer: keep the physical mouse pointer inside the host screen.
`UseMultitouchForPenAndMouse`	Boolean	`false`	Smart Touch Gestures: send Apple Pencil and mouse input as touches when the host supports touch input.
`useArdRightClickWorkAround`	Boolean	`false`	Alternate Right Click for VNC connections to Macs.

Linea and Infinea scanner keys#

These keys apply to Infinite Peripherals Linea and Infinea hardware.

Key	Type	Default	Description
`lineaScannerEnabled`	Boolean	`false`	Linea / Infinea Scanner. The other keys in this table require this key to be `true`.
`lineaBarcodeScanMode`	Integer	`0`	`0` Single, `1` Multiple, `2` Motion Detect, `3` Single Scan On Release, `4` Multiple (No Duplicates).
`lineaBeepOnScan`	Boolean	`true`	Beep after each scan.
`lineaPostBarcodeKeyStrokes`	String	`KEY_RETURN`	Keystrokes sent after each barcode scan. See Keystroke sequences.
`lineaPostMagneticStripeKeyStrokes`	String	`KEY_RETURN`	Keystrokes sent after each magnetic stripe swipe. See Keystroke sequences.
`lineaPostKeyStrokesDelayMS`	Integer	`100`	Delay, in milliseconds, before the post-scan keystrokes are sent.
`lineaMageticStripeTrack1Enabled`	Boolean	`true`	Read magnetic stripe track 1. The key is spelled `Magetic`.
`lineaMageticStripeTrack2Enabled`	Boolean	`true`	Read magnetic stripe track 2.
`lineaMageticStripeTrack3Enabled`	Boolean	`true`	Read magnetic stripe track 3.

Keystroke sequences#

Separate the parts of a sequence with |. Each part is either a key name, which sends that key, or text, which is typed as written. For example, KEY_TAB|KEY_TAB|KEY_RETURN sends Tab twice and then Return.

Key names	Keys
`KEY_RETURN`, `KEY_TAB`, `KEY_ESCAPE`, `KEY_BACKSPACE`, `KEY_DELETE`, `KEY_INSERT`	Editing keys
`KEY_LEFT`, `KEY_UP`, `KEY_RIGHT`, `KEY_DOWN`, `KEY_HOME`, `KEY_END`, `KEY_PAGE_UP`, `KEY_PAGE_DOWN`	Navigation keys
`KEY_F1` to `KEY_F35`	Function keys
`KEY_KP_0` to `KEY_KP_9`, `KEY_KP_ENTER`, `KEY_KP_ADD`, `KEY_KP_SUBTRACT`, `KEY_KP_MULTIPLY`, `KEY_KP_DIVIDE`, `KEY_KP_DECIMAL`	Numeric keypad keys
`KEY_VERTICAL_BAR`	Types a vertical bar character

Predefine computers#

Configure each computer in the app, export it, and paste its JSON into the configuration.

In Jump Desktop on iPhone or iPad, create and configure the computers.
Open Settings > Computer List and tap Export All Computers. Send the .jdz file to a Mac or PC.
Rename the file from .jdz to .zip and extract it.
Open each .jump file in the servers folder with a text editor.
Paste each file's contents as one string in servers, or into its own server1, server2, ... key.

Jump Desktop adds these computers each time it starts and when the configuration changes, and updates any computer with the same ID. If the user deletes a predefined computer, Jump Desktop adds it again at the next start. To remove a predefined computer, delete its entry from the configuration, and then delete the computer on the device.

For the .jump format, see Launch links and connection files.

Prevent editing#

Settings: push SettingsLock and SettingsLockPassword. Without MDM, the user can turn on Settings > Security > Lock Settings on the device.
A computer: in its .jump JSON, set "DisableServerEdit": true before you push it. The user can connect but cannot edit, duplicate, or share the computer.

To lock a computer without MDM:

Edit its exported .jump file as described above.
Compress the folder into a zip archive.
Rename the archive to .jdz.
Open the archive with Jump Desktop on the device to import it.