Skip to content

Install and uninstall Jump Desktop Connect

Jump Desktop Connect is the app you install on a computer so that you can access it remotely. Install it on each computer you want to reach, such as your office or home computer, then connect from Jump Desktop on another device.

To install Connect on many computers at once, see Deploy Connect to many computers.

Applies to

  • Someone with administrator rights at the remote computer.
  • Windows 10 or later (64-bit) and macOS 10.15 or later.
  • Linux (beta): Ubuntu, Red Hat Enterprise Linux (RHEL), Rocky Linux, and AlmaLinux, with systemd, on x86-64 or ARM64. The install script also accepts other distributions that use APT, DNF or YUM, or Zypper, but they aren't confirmed as supported yet. To connect when nobody is signed in, the computer needs an X11 desktop session installed.

Install Connect

  1. Download the Windows installer.
  2. Run it and approve the administrator prompt.

Connect opens when the installer finishes.

  1. Download the macOS installer.
  2. Open the disk image, then open Install Jump Desktop Connect and follow the installer.

Connect opens when the installer finishes. Next, grant macOS permissions to Connect; without them Connect can't show or control your Mac.

Connect for Linux is in beta.

  1. Get a Connect Code from the account or team that will access the computer.
  2. Run the install script with the code:

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

The script adds the Jump Desktop repository (using sudo), installs jump-connect, starts Connect, and adds the computer to that account or team. Updates come through your package manager.

Add the computer to your account

To reach this computer from your personal Jump Desktop account, add yourself as a remote access user. On Windows and macOS, a remote access user is a Jump Desktop account that can connect to this computer. On Linux, use a Connect Code at install instead.

If the Connect window isn't showing, click the Connect icon in the system tray (Windows) or menu bar (macOS: Jump Desktop Connect menu bar icon on macOS), then choose Show Jump Desktop Connect.

  1. In the Connect window, click Add a remote access user.
  2. Click Click here to sign in via your web browser... and sign in. To sign in on your phone instead, click Show QR Code and scan the code.

The account is added to the remote access list. Sign in with it in Jump Desktop on the device you connect from.

To set up a computer from a terminal or over SSH, including for your personal account, use Jump CLI (beta). To add the computer to a team instead, use a pre-configured installer (see Add and manage computers) or a Connect Code.

Uninstall Connect

After you uninstall Connect, nobody can connect to the computer remotely.

Uninstall Jump Desktop Connect from Apps in Windows Settings, or from Programs and Features in Control Panel.

  1. In the Connect window, click the settings (gear) icon.
  2. Select Uninstall, then click Uninstall Jump Desktop Connect.
  3. Click Yes, then enter an administrator password.

Remove the jump-connect package with your package manager:

sudo apt remove jump-connect      # Debian, Ubuntu
sudo dnf remove jump-connect      # Fedora, RHEL
sudo zypper remove jump-connect   # openSUSE, SUSE

Limitations

  • Uninstalling Connect doesn't remove the computer from your account or team. For a team, remove the computer in the Teams dashboard.
  • An administrator's policy can block adding remote access users. Connect then shows Not allowed to change remote access users.