Skip to content

Deploy Connect to many computers

Install Connect silently from a deployment tool, script, or remote shell, and add each computer to your team or account during install. It saves installing and signing in on each computer by hand, for example when rolling Connect out across an office.

Applies to

  • Remote computers running Windows (EXE or MSI installer), macOS (PKG installer), or Linux (beta; jump-connect package on Ubuntu, Red Hat Enterprise Linux (RHEL), Rocky Linux, or AlmaLinux). See Install Jump Desktop Connect for other distributions.

Choose how to enroll

Method Platforms Use it when
Pre-configured installer Windows, macOS Deploying to a team. The Connect Code is built into the installer's file name.
Standard installer plus a Connect Code Windows, macOS, Linux (beta) Deploying to Linux, when your tool renames installer files, or when Connect is already installed.

For a team, get either one in the Teams dashboard under Add Computers. See Add and manage computers. Every computer gets the installer's remote access permissions and Connect Configuration. Attributed installers need a sign-in, so don't use them here.

The Teams dashboard shows Connect Codes with spaces, such as 123 456 789. Remove the spaces on the command line: 123456789.

Deploy a pre-configured installer

  1. In Add Computers, open the installer and copy the Windows (EXE), Windows (MSI), or Mac OS (PKG) link.
  2. Download the file without renaming it: Connect reads the Connect Code from the file name, JumpDesktopConnect.CC<code>.DoNotRename.<ext>. With curl, use -O to keep the name.
  3. Install it silently:

Run from an elevated prompt:

msiexec /i "C:\Deploy\JumpDesktopConnect.CC<code>.DoNotRename.msi" /qn

For the EXE, pass the same option: JumpDesktopConnect.CC<code>.DoNotRename.exe /qn.

sudo installer -pkg "/tmp/JumpDesktopConnect.CC<code>.DoNotRename.pkg" -target /

The computer joins the team when the installer finishes.

Deploy with a Connect Code

Download the EXE or MSI installer and pass the code in CONNECTCODE:

msiexec /i "C:\Deploy\JumpDesktopConnect.msi" /qn CONNECTCODE=123456789
JumpDesktopConnect.exe /qn CONNECTCODE=123456789

Optional installer variables:

Variable Effect
RDPENABLED=true Turns on RDP tunneling. false turns it off.
FLUIDENABLED=true Turns on Fluid. false turns it off.

If Connect 10.12.15 or later is already installed, run JumpConnectCli.exe --connectcode, the command-line version of Connect in the same folder as JumpConnect.exe (the ConnectPath value under HKEY_LOCAL_MACHINE\SOFTWARE\Jump Desktop\Connect\Shared). It prints Success! when the code is applied. In 64-bit PowerShell:

$connect = (Get-ItemProperty "HKLM:\SOFTWARE\Jump Desktop\Connect\Shared").ConnectPath
$cli = Join-Path (Split-Path $connect) "JumpConnectCli.exe"
& $cli --connectcode 123456789

On older versions, run JumpConnect.exe instead. It prints nothing to the console, so wait for it to finish:

Start-Process -FilePath $connect -ArgumentList "--connectcode 123456789" -Wait

Download the PKG installer, install it, then apply the code:

sudo installer -pkg /tmp/JumpDesktopConnect.pkg -target /
"/Applications/Jump Desktop Connect.app/Contents/MacOS/JumpConnect" --connectcode 123456789

Connect prints Success! when the code is applied.

The install script adds the package repository, installs Connect, and applies the code:

curl -fsSL https://jumpdesktop.com/downloads/install.sh | sh -s -- --component connect --connectcode 123456789

The script uses sudo for steps that need root. --component connect stops it prompting.

If Connect is already installed, apply the code directly (no root needed):

/usr/libexec/jump/jumpconnect --connectcode 123456789

Set Connect settings from the command line

Run Connect with --serverconfig NAME=VALUE, repeated as needed. For example, to name a computer before enrolling it:

Run JumpConnectCli.exe from the Connect installation folder (Connect 10.12.15 or later; see Deploy with a Connect Code). In 64-bit PowerShell:

$connect = (Get-ItemProperty "HKLM:\SOFTWARE\Jump Desktop\Connect\Shared").ConnectPath
$cli = Join-Path (Split-Path $connect) "JumpConnectCli.exe"
& $cli --serverconfig ComputerName=Office-PC-01
& $cli --connectcode 123456789

"/Applications/Jump Desktop Connect.app/Contents/MacOS/JumpConnect" --serverconfig ComputerName=Office-Mac-01
"/Applications/Jump Desktop Connect.app/Contents/MacOS/JumpConnect" --connectcode 123456789

/usr/libexec/jump/jumpconnect --serverconfig ComputerName=Office-Linux-01
/usr/libexec/jump/jumpconnect --connectcode 123456789

Set ComputerName before --connectcode: the name is sent when the code is applied. To manage a team's settings centrally, use Connect Configurations.

Result

The computer appears under Computers in the Teams dashboard, or in the account that issued the Connect Code. Connect on the computer lists the team or account as a remote access user.

Limitations

  • Anyone with a pre-configured installer link or its Connect Code can add a computer to your team. Revoke an installer in Add Computers when you no longer need it.
  • On Windows, and with a pre-configured macOS installer, the installation succeeds even if the Connect Code can't be applied (for example, it's invalid or the computer is offline). Confirm each computer was added as described in Result.
  • On macOS, someone at each Mac must grant Connect the Screen Recording, Accessibility, and Remote Desktop (macOS 14 and later) permissions. See Grant macOS permissions to Connect.