Skip to content

Add a computer with a Connect Code#

A Connect Code is a code for adding a computer to a Jump Desktop account or team without sharing a password. A Connect Code cannot be used to sign in. Use a Connect Code when a person at another computer needs to give you access, or to add a computer that already has Jump Desktop Connect installed to a team.

Code from What entering it does
A personal account Adds that account as a remote access user on the computer.
A team Adds the computer to the team. Team administrators then manage the computer's configuration and access permissions.

Applies to#

  • Hosts running Jump Desktop Connect on Windows, macOS, or Linux Alpha.
  • The person at the host enters the code.

Get a Connect Code#

Personal account: Sign in to the Jump Desktop dashboard and click Home. Your code appears under Your Connect Codes. If you do not have a code, click Create My Personal Connect Code. Use the controls next to the code to copy it, or to send setup instructions to the person at the host with Shareable Link or Mail Instructions.

Team: An administrator copies the Connect Code of an installer in Add Computers. For details, see Add and manage computers.

The dashboard displays codes with spaces, such as 123 456 789.

Enter the code in Connect#

Warning

Use a code only if you trust the person who sent it; that person will be able to connect to this computer.

  1. Install Jump Desktop Connect and open it.
  2. Click Add a remote access user.
  3. Click Click here to sign in via your web browser...
  4. In the browser, click Give remote access to someone else.
  5. Enter the code and click Next.
  6. Check the account or team name, then click Allow. If the page shows Sign in to Allow, sign in with any Jump Desktop account first.
  1. Install Jump Desktop Connect and open it.
  2. Click Add a remote access user.
  3. Click Click here to sign in via your web browser...
  4. In the browser, click Give remote access to someone else.
  5. Enter the code and click Next.
  6. Check the account or team name, then click Allow. If the page shows Sign in to Allow, sign in with any Jump Desktop account first.

Pass the code to the install script (see Install Jump Desktop Connect). If Connect is already installed, run:

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

To add computers with scripts on any platform, see Deploy with a Connect Code. On the command line, enter the code without spaces.

Result#

  • Personal code: The account appears in Connect's list of remote access users. To connect, sign in to Jump Desktop with that account.
  • Team code: The computer appears under Computers in the Teams dashboard, with the installer's remote access permissions and Connect Configuration applied.

Reuse and revoke#

  • Connect Codes created in the dashboard do not expire and can be used on any number of computers.
  • Personal code: In Your Connect Codes, click Delete. The code stops working. To remove the account from a computer it was already added to, remove the account from the remote access users in Connect on that computer.
  • Team code: Delete the installer in Add Computers. Computers already added remain in the team.

Limitations#

  • A computer can belong to only one team. A team code fails on a computer linked to another team until the computer is removed from that team.
  • Codes from attributed installers require the person at the host to sign in, so these codes do not work with --connectcode.
  • If a policy blocks adding remote access users, Connect shows Not allowed to change remote access users.