Install the Windows Agent

Managing all of your Windows® devices in JumpCloud® starts by installing JumpCloud's device agent.

Prerequisites:

After installation you must connect user accounts to your devices to provide users access to JumpCloud-managed resources. Then you can set policies, execute commands, enable MFA, and more.

The agent:

  • Lives on the local device (takes 5-7 MB of RAM)
  • Contacts JumpCloud servers in near real-time securely using a long HTTPS poll through port 443
  • Displays the device status in the Administrator Portal

The agent manages local user accounts and has the ability to add, modify, and delete them. The agent can set passwords and update full name fields. When the agent checks in with the JumpCloud servers, it also looks for instructions from you, sets policies, reports event data about user logins, and runs commands.

Tip:

New remote employees? No problem. You can enable remote installation of the JumpCloud agent from the User Portal, making it easy for new remote employees to install the agent on their work computers from home. See Enable Users to Install the Agent.

Installing the Windows Agent from Terminal

Note:

Find the PowerShell Script to download and install the JumpCloud agent silently here.

To remotely install the Windows agent:

  1. Run Windows Terminal as an administrator, then connect to the deployment tool you plan to use to remotely download and install the Windows agent.
  2. Copy the PowerShell script, then paste it into Windows Terminal.
  3. Edit and insert your connect key in this line: $CONNECT_KEY=”your-JumpCloud-Connect-Key-here”.
  4. Run the script.

To manually install the Windows agent from Terminal:

  1. Log in to a Windows device as an administrator.
  2. Open Windows Terminal.
  3. Download the installer. Learn how to download the agent installer from Terminal: Install the Agent from Command Line.
  4. Change the directory where jcagent-msi-signed.msi resides.
  5. Depending on if you are running the command line or PowerShell, insert your connect key and then run:
  • For the Command Line:

msiexec /i “<path to file>\<msi name>.msi” /quiet JCINSTALLERARGUMENTS=”-k YOUR_CONNECT_KEY_HERE /VERYSILENT /SUPPRESSMSGBOXES”

  • For PowerShell:

msiexec /i “<path to file>\<msi name>.msi” /quiet JCINSTALLERARGUMENTS=`”-k YOUR_CONNECT_KEY_HERE /VERYSILENT /SUPPRESSMSGBOXES`”

Helpful Command Line Options:

Tip:

To show all command line options available for Windows, use /help.

  • -k YOUR_CONNECT_KEY allows you to set your connect key for unattended installations.
  • /SILENT displays the installer GUI, but walks through the steps automatically. It will prompt you if you wish to reboot now, or when the install is complete.
  • /VERYSILENT hides the installer GUI and walks through the steps automatically. It will automatically reboot once finished.
  • /NORESTART prevents setup from restarting the device following a successful installation. Typically used along with /SILENT or /VERYSILENT.
  • /SUPPRESSMSGBOXES answers yes to any installation dependencies, such as MFC redistributables.

Installing the Windows Agent Manually

To install the Windows agent manually:

  1. Locate the jcagent-msi-signed.msi file, then open it.
  2. In the installation wizard, on the Select Destination Location page, make sure it is set to C:\Program Files\JumpCloud, and then click Next.
  3. Click Install.
  4. Paste the JumpCloud Device Connect Key that you copied when you downloaded the agent, then click Continue.
  5. If another application is using files that the installation needs access to, select Automatically close the applications, or manually close the application, then select Do not close the application.
  6. Click Next, then Finish.

Verifying Windows Installation from Programs and Features

To verify the Windows agent installation from Programs and Features:

  1. Click Start.
  2. Select Control Panel.
  3. Select Programs > Programs and Features. If successfully installed, you should see the JumpCloud agent and the agent version in the programs pane.

Verifying Windows Agent Installation from Windows Service

The JumpCloud Agent operates as a Windows service and can be viewed in the Services Manager.

To verify the Windows Agent installation from Windows Service:

  1. Click Start, then Run.
  2. In the Open field, enter services.msc, then click OK.
  3. Find the JumpCloud agent. Running should be listed in the Status column.

Verifying Windows Agent Installation from the Admin Portal

To verify the Windows Agent installation from the Admin Portal:

  1. Log in to the JumpCloud Admin Portal: https://console.jumpcloud.com.
  2. Go to DEVICE MANAGEMENT > Devices.
  3. In the Devices list, the Status of the new device will have a green check mark next to it if added successfully.

Troubleshooting

A device can't be managed in JumpCloud until the agent has been successfully installed. If you encounter issues, see Troubleshoot: Windows Agent Freezes During Install.

Still Have Questions?

If you cannot find an answer to your question in our FAQ, you can always contact us.

Submit a Case