Skip to content

Reset Connect

Resetting Connect returns it to factory defaults and removes the computer's link to its account or team. Use it to start over, for example to add the computer to a different account or team. Before capturing a computer image, prepare Connect for cloning instead, so each copy registers as a new computer.

Warning

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

Applies to

  • Remote computers running Jump Desktop Connect on Windows, macOS, or Linux (beta).
  • On team computers, reset and Prepare For Cloning require Local Configuration Changes in the computer's Connect Configuration. Without it, Connect shows Settings are managed by your team's administrator, and --resetconfig and --prepareclone silently do nothing.

Reset from the Connect window

  1. On the remote computer, 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. Connect must be running. The command doesn't need administrator rights 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 can't reach the running Connect service within 15 seconds, it prints an error and exits.

Result

Connect is back to factory defaults. Add the computer again with a Connect Code or another method in Add and manage computers.

On a team, a reset doesn't remove the computer from the Teams dashboard. Its old entry stays under Computers until an administrator removes it, and the reset computer comes back as a new computer when added again.

Prepare a computer image for cloning

Prepare Connect before capturing an image so each restored copy registers as a new computer. Settings are kept.

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

The next time the computer or a restored copy starts, it shows up as a new computer. From the command line, run Connect with --prepareclone instead of --resetconfig.