Skip to content

Reset Connect#

A Connect reset restores Jump Desktop Connect to factory defaults and removes the host's link to its account or team. Use a reset to start over, for example to add the host to a different account or team. Before you capture a computer image, prepare Connect for cloning instead so that each copy registers as a new computer.

Warning

A reset deletes all Connect settings on the host, including its link to your account or team and, on macOS, the values Connect stores in the keychain. No user can connect remotely until you add the host again.

Applies to#

  • Hosts running Jump Desktop Connect on Windows, macOS, or Linux Alpha.
  • On team computers, reset and Prepare For Cloning require the Local Configuration Changes setting in the computer's Connect Configuration. Without this setting, Connect displays Settings are managed by your team's administrator, and --resetconfig and --prepareclone have no effect and report no error.

Reset from the Connect window#

  1. On the host, open Connect and click the Settings (gear) button.
  2. Select Configuration.
  3. Next to Reset settings to factory defaults, click Reset Settings.
  4. Click Yes to confirm.

Reset from the command line#

Run Connect with --resetconfig while Connect is running. The command does not require administrator privileges or sudo, so any local user can reset Connect.

In PowerShell:

$connect = (Get-ItemProperty "HKLM:\SOFTWARE\Jump Desktop\Connect\Shared").ConnectPath
Start-Process -FilePath $connect -ArgumentList "--resetconfig" -Wait

"/Applications/Jump Desktop Connect.app/Contents/MacOS/JumpConnect" --resetconfig

/usr/libexec/jump/jumpconnect --resetconfig

On macOS and Linux, if the command cannot reach the running Connect service within 15 seconds, it prints an error and exits.

Result#

Connect is restored to factory defaults. To add the host again, use a Connect Code or another method in Add and manage computers.

On a team, a reset does not remove the host from the Teams dashboard. Its previous entry remains under Computers until an administrator removes it, and the reset host appears as a new computer when you add it again.

Prepare a computer image for cloning#

Prepare Connect before you capture an image so that each restored copy registers as a new computer. Connect settings are retained.

  1. In Connect, click the Settings (gear) button and select Configuration.
  2. Next to Prepare to run on cloned machine, click Prepare For Cloning, and then click Yes.
  3. Capture the image.

The next time the host or a restored copy starts, it appears as a new computer. To prepare for cloning from the command line, run Connect with --prepareclone instead of --resetconfig.