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. For computer images or copies sharing a registration, follow Clone computers with Connect to uninstall Connect and delete its leftover data.
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 requires 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
--resetconfighas no effect and reports no error.
Reset from the Connect window#
On Windows or macOS, use the steps below. On Linux, use Reset from the command line.
- On the host, open Connect and open Settings.
- Select Configuration.
- Next to Reset settings to factory defaults, click Reset Settings.
- Click Yes to confirm.
Reset from the command line#
Run Connect with --resetconfig while Connect is running. Administrator privileges or sudo are not required. To prevent local users from resetting managed team hosts, turn off Local Configuration Changes in the assigned Connect Configuration.
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.