Add a Device

You can connect Mac, Windows, and Linux devices to JumpCloud by installing the JumpCloud agent. See Agent Compatibility, System Requirements and Impacts before you install the agent.

The JumpCloud agent is small, secure, and keeps itself up-to-date. The agent checks in with JumpCloud securely through port 443, provides status, sets policies, reports login event data, etc. See Understand the Agent.

Adding a Device

To add a new device:

  1. Log in to the JumpCloud Admin Portal.
  2. Go to DEVICE MANAGEMENT Devices. 
  3. Select the Devices tab.
  4. Click ( + ). The New Device panel that appears contains various device tabs. Each tab includes information about downloading and installing the JumpCloud agent for that device’s OS. You can also read the following about installing agents from the command linetemplate or System Image, or the JumpCloud API.
  5. (Optional) You can add the JumpCloud agent to your allow list with your AntiVirus vendor.
  6. After installation completes, the agent checks in with JumpCloud and is active in the Admin Portal. You can view details about the device on the Device panel.

Viewing Device Information

You can view details about the device, use security commands, and turn on JumpCloud's System Insights, and MFA.

To view device information:

  1. Log in to the JumpCloud Admin Portal.
  2. Go to DEVICE MANAGEMENT > Devices.
  3. Select the Devices tab, then select a device.


To quickly locate a specific device, you can search for it or click filter by and narrow your search by serial number, OS version, enrollment status, system name, JumpCloud system ID, and so on.

  1. Review the reporting information in the Highlights tab, as well user, device groups, and policies that are bound to this device. The Highlights tab is the default landing tab for information about an individual device, such as OS version, serial number, IP address, last user login, etc.

    The Device Name is captured when the JumpCloud Agent is installed on a device. The Device Name is not dynamically updated after that. However, that field is editable, so you can change the device’s name at any time. The device’s Hostname is updated dynamically at regular intervals, and you will see a Hostname updated within two hours after a change locally on a device, presuming the device remains online. Currently there is no mechanism to force an immediate Hostname update in the Admin Portal.

    The Highlights tab also provides a summary of the users, device groups, and policies that are connected to the device. For more information, see JumpCloud System Insights. When you create a new device, the Highlights tab is empty.
  2. Review the Device Activity section of the Highlights tab to see the Events, Resource/Status, and Timestamp when the events occurred. Organizations that are on all pricing plans see the Device Activity widget in the Device Panel Highlights tab. If you want to see more Device Activity details, click activity log. Directory Insights customers are directed to the Directory Insights activity log with the Device filter applied for the device they are viewing. Customers without Directory Insights can add this feature by contacting their Account Manager.
  3. Perform any of these options that appear on the left:
    • Enable System Insights – Gather useful information from your JumpCloud managed devices and view that information on the Details tab. See JumpCloud System Insights.
    • Enable TOTP Multi-factor Authentication (MFA) – See Enable TOTP MFA for Devices.
    • Run Security Commands – Mobile Device Management (MDM) commands are available to macOS and iOS devices enrolled in MDM. See MDM Commands. Security commands are available to lock, erase, and reset passcodes for Android devices. See Add and Manage Android Devices.
  4. Manage MFA requirements or enable System Insights by clicking the more actions menu. This menu lets you enable actions across one or more devices from the list view. The more actions menu is inactive until one or more devices are selected. See Get Started: Admin Portal for more information.
  5. To customize the Devices List, you can choose which columns to display. Columns include Created, Device Name, OS, Primary Adapter IP, MFA Status, and Created. You can’t remove a device’s status and name from the list view, but you can customize the other columns. For example, instead of showing OS, use the columns feature to show the agent version or when the device was created. You can also display serial numbers, secure token details, or other important details. You can select up to eight columns, and you can use the search bar at the top of the list to narrow column results. To return to the default columns for Device, click Revert to default columns.
  6. Select the Details tab to view this information:
    • Device information – The device name, status, a description, system uptime, hardware information, and other details.
    • Logs – Click Get agent log to download the most recent 1MB of logs for the system. Logs are available only for online systems. It may take some time to download all logs for a system.
    • SSH Options (Linux) – These options modify the SSHD configuration. The agent attempts to control the SSHD configuration regardless of other software it may interact with. 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.
  7. To export all of your device information for audits, compliance, or troubleshooting reports, click export to export to either CSV or JSON.
    1. Log in to the Administrator Portal:
    2. Go to DEVICE MANAGEMENT Devices.
    3. Click export, then select either Export JSON or Export CSV. Your list of devices is exported into the format of your choice and is saved as jcudeviclist_yyyymmdd.<filetype>.

The next step in managing devices is to Add Users and User Groups to a Device and Assign a Policy to a Device.

Still Have Questions?

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

Submit a Case