Legacy RADIUS server IPs will be deprecated on Jan 31, 2019. Please see this KB for more info.

Support Center

Getting Started: Systems

Mac, Windows, or Linux systems are bound to JumpCloud by installing JumpCloud's system agent. Please check JumpCloud Agent Compatibility, System Requirements and Impacts prior to installing. Once installed and bound, you can remotely and securely manage these systems and their user accounts, set policies, execute commands, enable MFA, and more.
  • Create, modify, and disable local user accounts
  • Manage SSHD configuration (Linux)
  • Enforce MFA (Mac, Linux SSH)
  • The execution of Commands

About the Agent
The agent is small, secure, and keeps itself up-to-date. It's designed to check in with JumpCloud securely through port 443 and tell you its status, look for instructions from you (e.g. changing a user's password), set policies, report login event data, and more.

Add a System
To add a new system, go to Systems, select the +  

This will present a New System side panel. Here you will be presented with tabs for the appropriate OS download and some documentation around using Puppet or Chef to manage the installation. There is also documentation on command line deployment, deploying via template or AMI, or leveraging the JumpCloud API.

For information on whitelisting the JumpCloud agent with your AntiVirus vendor.

Installation should complete within 1-2 minutes, check in, and show active in the console. Once available, select the system record to be presented with the system Details side panel.

System Details
  • Display Name - This will default to the hostname of the system, but can be set to any desired string
  • Immutable details - Details like the hostname, IP, and other fields that cannot be modified are kept up to date on a regular basis via the agent service
  • SSH Options (Linux) - These options will modify the SSHD configuration. The agent will attempt to control the SSHD configuration regardless of other software that may interact with it. Configuration management, other security modules, or anything else that may attempt to change these files in conjunction with the agent may result in adverse behavior.  

System Groups

  • Displays System group membership and allows the system to be added or removed from (de)selected groups. To create a group, see Getting Started: Groups.


Once the agent is installed, you can provision new local user accounts to the system
or bind to existing users with matching usernames.

  • Displays the relationship between the system and bound users
  • Bound via Group Membership:
    • Users with 'Enable Permissions' displayed means they are bound to the system via group membership.
    • If the binding is removed, you will be presented the option to remove the user from the group granting access.
    • Select 'Enable Permissions' to create a direct binding between user and system to allow for Standard User or Administrator permissions to be set. Group membership for the user remains unchanged.
  • Bound directly:
    • Users with a permission displayed mean the user is bound directly to the system.
    • Type of permission can be defined for this individual user
    • If the binding is removed, the direct relationship between system and user is removed. The user may still have access granted to the system via Group membership as above. Direct binding sits "On top" of Group membership in the UI



Last Updated: Nov 26, 2018 03:05PM MST

Related Articles
seconds ago
a minute ago
minutes ago
an hour ago
hours ago
a day ago
days ago
Invalid characters found