Skip to content

Configure Jump Desktop for iOS and iPadOS with MDM

Push settings and predefined computers to Jump Desktop on iPhone and iPad through your MDM's managed app configuration. For example, lock settings, stop users saving credentials, or give every managed device the same list of computers. Jump Desktop for Android has no managed app configuration.

Deliver the configuration

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

A key you set overrides the user's choice while the configuration is installed. Keys you leave out keep 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 next launch. Always set SettingsLockPassword too, or settings can't be unlocked.
SettingsLockPassword String None Password for SettingsLock.
ShowLockScreen Boolean false Lock the app when the user leaves it. Unlock with Face ID, Touch ID, or the device passcode. 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 remote computer 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 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, one .jump document per key. Number 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 keeps the device from sleeping or auto-locking during a session (Disable Sleep on).
ZoomOutFullyOnConnect Boolean true Start Zoomed Out: show the whole remote 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 remote computer 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 remote screen.
UseMultitouchForPenAndMouse Boolean false Smart Touch Gestures: send Apple Pencil and mouse input as touches when the remote computer supports touch input.
useArdRightClickWorkAround Boolean false Alternate Right Click for VNC connections to Macs.

Linea and Infinea scanner keys

For Infinite Peripherals Linea and Infinea hardware.

Key Type Default Description
lineaScannerEnabled Boolean false Linea / Infinea Scanner. The other keys in this table need this set to 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 before sending those keystrokes, in milliseconds.
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, 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

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

  1. In Jump Desktop on iPhone or iPad, create and set up the computers.
  2. Open Settings > Computer List and tap Export All Computers. Send the .jdz file to a Mac or PC.
  3. Rename the file from .jdz to .zip and extract it.
  4. Open each .jump file in the servers folder with a text editor.
  5. 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, updating any computer with the same ID. A predefined computer the user deletes comes back at the next start. To remove one, delete its entry from the configuration, 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 can't edit, duplicate, or share the computer.

To lock a computer without MDM, edit its exported .jump file as above, zip the folder, rename the archive to .jdz, and open it with Jump Desktop on the device to import it.