{"id":74720,"date":"2023-06-05T13:12:17","date_gmt":"2023-06-05T17:12:17","guid":{"rendered":"https:\/\/jumpcloud.com\/?post_type=support&p=74720"},"modified":"2024-12-11T08:01:54","modified_gmt":"2024-12-11T13:01:54","slug":"install-the-agent","status":"publish","type":"support","link":"https:\/\/jumpcloud.com\/support\/install-the-agent","title":{"rendered":"Install or Uninstall the JumpCloud Agent"},"content":{"rendered":"\n<p>This article covers the manual ways to install or uninstall the JumpCloud Agent via the JumpCloud Admin Portal on various operating systems.<\/p>\n\n\n\n<p><strong>Prerequisites:<\/strong>\u200b<\/p>\n\n\n\n<ul>\n<li>Root or Admin Access<\/li>\n\n\n\n<li><a href=\"https:\/\/jumpcloud.com\/support\/agent-compatibility-system-requirements-and-impacts\" target=\"_blank\" rel=\"noreferrer noopener\">Supported OS<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/jumpcloud.com\/support\/agent-networking-and-port-requirements\" target=\"_blank\" rel=\"noreferrer noopener\">Internet Connectivity and Time synchronization<\/a><\/li>\n\n\n\n<li>curl (for Linux deployments)<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Installing the Agent<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">Install the JumpCloud Agent on a MacOS Device<\/h3>\n\n\n\n<ol>\n<li>Log in to the <a href=\"https:\/\/console.jumpcloud.com\/login\" target=\"_blank\" rel=\"noreferrer noopener\">JumpCloud Admin Portal<\/a>.<\/li>\n\n\n\n<li>Go to <strong>DEVICE MANAGEMENT<\/strong> > <strong>Devices<\/strong>.<\/li>\n\n\n\n<li>Click <strong>+<\/strong> to add a device and click the <strong>Mac<\/strong> tab.<\/li>\n\n\n\n<li>Select the <strong>Install via Mac Agent <\/strong>option.<\/li>\n\n\n\n<li>If you are currently on the target system, click <strong>Download Mac Agent<\/strong>. If not, click <strong>Copy Download Link<\/strong> to copy the link URL and open the link in a browser on the target system.<\/li>\n\n\n\n<li>Copy the <strong>Connect Key<\/strong>.<\/li>\n\n\n\n<li>Run <strong>jumpcloud-agent.pkg<\/strong>. <\/li>\n\n\n\n<li>Follow the installer and enter the <strong>Connect Key<\/strong> when prompted.<\/li>\n<\/ol>\n\n\n\n<div class=\"wistia_responsive_padding\" style=\"padding:56.25% 0 0 0;position:relative\"><div class=\"wistia_responsive_wrapper\" style=\"height:100%;left:0;position:absolute;top:0;width:100%\"><div class=\"wistia_embed wistia_async_yatcyaho3j seo=true videoFoam=true\" style=\"height:100%;position:relative;width:100%\"><div class=\"wistia_swatch\" style=\"height:100%;left:0;overflow:hidden;position:absolute;top:0;width:100%\"><img decoding=\"async\" src=\"https:\/\/fast.wistia.com\/embed\/medias\/yatcyaho3j\/swatch\" style=\"height:100%;object-fit:contain;width:100%\" alt=\"\" aria-hidden=\"true\" \/><\/div><\/div><\/div><\/div>\n\n\n\n<h3 class=\"wp-block-heading\">Install the JumpCloud Agent on a Windows Device<\/h3>\n\n\n\n<ol>\n<li>Log in to the <a href=\"https:\/\/console.jumpcloud.com\/login\" target=\"_blank\" rel=\"noreferrer noopener\">JumpCloud Admin Portal<\/a>.<\/li>\n\n\n\n<li>Go to <strong>DEVICE MANAGEMENT<\/strong> > <strong>Devices<\/strong>.<\/li>\n\n\n\n<li>Click <strong>+<\/strong> to add a device and click the <strong>Windows<\/strong> tab.<\/li>\n\n\n\n<li>Select the <strong>Install via MSI Download <\/strong>option.<\/li>\n\n\n\n<li>If you are currently on the target system, click <strong>Download Windows Agent<\/strong>. If not, click <strong>Copy Download Link<\/strong> to copy the link URL and open the link in a browser on the target system. <\/li>\n\n\n\n<li>Copy the <strong>Connect Key<\/strong>.<\/li>\n\n\n\n<li>Run <strong>jcagent-msi-signed.msi<\/strong>.<\/li>\n\n\n\n<li>Follow the wizard and enter the <strong>Connect Key<\/strong> when prompted.<\/li>\n\n\n\n<li>For a step by step walkthrough, refer to\u00a0<a href=\"https:\/\/jumpcloud.com\/support\/jumpcloud-agent-windows-installation-walkthrough\" target=\"_blank\" rel=\"noreferrer noopener\">JumpCloud Agent Windows Installation Walkthrough<\/a>.<\/li>\n<\/ol>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"h-install-the-jumpcloud-agent-on-a-linux-device\">Install the JumpCloud Agent on a Linux device<\/h3>\n\n\n\n<ol>\n<li>Log in to the <a href=\"https:\/\/console.jumpcloud.com\/login\" target=\"_blank\" rel=\"noreferrer noopener\">JumpCloud Admin Portal<\/a>.<\/li>\n\n\n\n<li>Go to <strong>DEVICE MANAGEMENT<\/strong> > <strong>Devices<\/strong>.<\/li>\n\n\n\n<li>Click <strong>+<\/strong> to add a device and click the <strong>Linux<\/strong> tab.<\/li>\n\n\n\n<li>Copy the displayed Install Command into the target system, or, if you already have your connect key, log in to the target machine as either sudoer or root and run the following:<\/li>\n<\/ol>\n\n\n\n<div class=\"wp-block-cgb-code-block code-block\"><div class=\"code-block-snippet is-type-body-default\">\n<p>curl –silent –show-error –header ‘x-connect-key: <em>YOUR_CONNECT_KEY<\/em>‘ https:\/\/kickstart.jumpcloud.com\/Kickstart | sudo bash<\/p>\n<\/div><\/div>\n\n\n\n<div class=\"wp-block-cgb-notification-card-wysiwyg notification-card tip\"><div class=\"notification-card-content\"><div class=\"notification-card-icon\"><p><img decoding=\"async\" src=\"\/wp-content\/themes\/jumpcloud\/assets\/images\/gutenberg-blocks\/tip-icon.png\" \/><\/p><\/div><div class=\"notification-card-copy is-type-body-default\"><div><strong class=\"notification-card-type\">Tip:<\/strong> \n<p>For steps to install the Linux agent via automation tools (Ansible, Chef, and Puppet) see <a href=\"https:\/\/jumpcloud.com\/support\/install-the-linux-agent\" target=\"_blank\" rel=\"noreferrer noopener\">Install the Linux Agent<\/a>.<\/p>\n <\/div><\/div><\/div><\/div>\n\n\n\n<h2 class=\"wp-block-heading\">Uninstalling the Agent<\/h2>\n\n\n\n<p>If you don’t want JumpCloud to manage a device, remove the following components:<\/p>\n\n\n\n<ul>\n<li>The device\u2019s record from the Admin Portal.<\/li>\n\n\n\n<li>The agent from the local device.<\/li>\n\n\n\n<li>Any JumpCloud policies on the local device.<\/li>\n<\/ul>\n\n\n\n<p>If a device is active, all of these components are automatically removed for you. You can find the status of a device in the Admin Portal in the Devices list. Depending on the device status, the agent’s components are uninstalled in the following ways:<\/p>\n\n\n\n<div class=\"wp-block-wpdatatables-wpdatatables-gutenberg-block\">\n <h3 class=\"wpdt-c\"\n id=\"wdt-table-title-27\">Component Uninstall Based on Device Status<\/h3>\n<div class=\"wpdt-c row wpDataTableContainerSimpleTable wpDataTables wpDataTablesWrapper\n\"\n >\n <table id=\"wpdtSimpleTable-27\"\n style=\"border-collapse:collapse;\n border-spacing:1px;\"\n class=\"wpdtSimpleTable wpDataTable\"\n data-column=\"4\"\n data-rows=\"3\"\n data-wpID=\"27\"\n data-responsive=\"0\"\n data-has-header=\"1\">\n\n <thead> <tr class=\"wpdt-cell-row \" >\n <th class=\"wpdt-cell \"\n data-cell-id=\"A1\"\n data-col-index=\"0\"\n data-row-index=\"0\"\n style=\" width:25%; padding:10px;\n \"\n >\n Status <\/th>\n <th class=\"wpdt-cell \"\n data-cell-id=\"B1\"\n data-col-index=\"1\"\n data-row-index=\"0\"\n style=\" width:25%; padding:10px;\n \"\n >\n Device Record <\/th>\n <th class=\"wpdt-cell \"\n data-cell-id=\"C1\"\n data-col-index=\"2\"\n data-row-index=\"0\"\n style=\" width:25%; padding:10px;\n \"\n >\n Agent <\/th>\n <th class=\"wpdt-cell \"\n data-cell-id=\"D1\"\n data-col-index=\"3\"\n data-row-index=\"0\"\n style=\" width:25%; padding:10px;\n \"\n >\n Policies <\/th>\n <\/tr>\n <tbody> <tr class=\"wpdt-cell-row \" >\n <td class=\"wpdt-cell wpdt-align-left wpdt-bold\"\n data-cell-id=\"A2\"\n data-col-index=\"0\"\n data-row-index=\"1\"\n style=\" padding:10px;\n \"\n >\n Active, System Reporting <\/td>\n <td class=\"wpdt-cell \"\n data-cell-id=\"B2\"\n data-col-index=\"1\"\n data-row-index=\"1\"\n style=\" padding:10px;\n \"\n >\n Removed <\/td>\n <td class=\"wpdt-cell \"\n data-cell-id=\"C2\"\n data-col-index=\"2\"\n data-row-index=\"1\"\n style=\" padding:10px;\n \"\n >\n Removed <\/td>\n <td class=\"wpdt-cell \"\n data-cell-id=\"D2\"\n data-col-index=\"3\"\n data-row-index=\"1\"\n style=\" padding:10px;\n \"\n >\n Removed <\/td>\n <\/tr>\n <tr class=\"wpdt-cell-row \" >\n <td class=\"wpdt-cell wpdt-align-left wpdt-bold\"\n data-cell-id=\"A3\"\n data-col-index=\"0\"\n data-row-index=\"2\"\n style=\" padding:10px;\n \"\n >\n Inactive, System Not Reporting <\/td>\n <td class=\"wpdt-cell \"\n data-cell-id=\"B3\"\n data-col-index=\"1\"\n data-row-index=\"2\"\n style=\" padding:10px;\n \"\n >\n Removed <\/td>\n <td class=\"wpdt-cell \"\n data-cell-id=\"C3\"\n data-col-index=\"2\"\n data-row-index=\"2\"\n style=\" padding:10px;\n \"\n >\n Not removed <\/td>\n <td class=\"wpdt-cell \"\n data-cell-id=\"D3\"\n data-col-index=\"3\"\n data-row-index=\"2\"\n style=\" padding:10px;\n \"\n >\n Not removed <\/td>\n <\/tr>\n <\/table>\n<\/div><\/div>\n\n\n\n<p>There are two methods to uninstall the agent:<\/p>\n\n\n\n<ul>\n<li>Using the Admin Portal to Uninstall the Agent<\/li>\n\n\n\n<li>Using the JumpCloud API to Uninstall the Agent<\/li>\n<\/ul>\n\n\n\n<p>Both of these tools can uninstall all agent components from Mac, Windows, and Linux devices.<\/p>\n\n\n\n<p><strong>Considerations<\/strong>:<\/p>\n\n\n\n<ul>\n<li>In rare cases, policies aren\u2019t removed automatically from Windows devices. If this happens, you can manually remove Windows policies.<\/li>\n\n\n\n<li>Uninstalling the agent from a device should be used as a last resort if the device is no longer online or communicating with JumpCloud.<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Using the Admin Portal to Uninstall the Agent<\/h3>\n\n\n\n<p>When you remove the agent from a device, all associated policies, files, and directories are also removed. See the complete list in <a href=\"https:\/\/jumpcloud.com\/support\/agent-compatibility-system-requirements-and-impacts\" target=\"_blank\" rel=\"noreferrer noopener\">Agent Compatibility, System Requirements, and Impacts<\/a>.<\/p>\n\n\n\n<p><strong>Considerations<\/strong>:<\/p>\n\n\n\n<ul>\n<li>If you log on to a device and manually remove the agent first, a record remains in the Admin Portal. You can use these steps to remove only the device record if the device has a status of <strong>Inactive, System Not Reporting<\/strong>.<\/li>\n<\/ul>\n\n\n\n<p><strong>To uninstall the agent from the Admin Portal<\/strong>:<\/p>\n\n\n\n<ol>\n<li>Log in to the <a href=\"https:\/\/console.jumpcloud.com\/login\" target=\"_blank\" rel=\"noreferrer noopener\">JumpCloud Admin Portal<\/a>.<\/li>\n\n\n\n<li>Go to <strong>Device Management<\/strong> > <strong>Devices<\/strong>.<\/li>\n\n\n\n<li>Select the device you want to stop managing. To uninstall all JumpCloud components associated with the device, make sure it has a status of <strong>Active, System Reporting<\/strong>.<\/li>\n\n\n\n<li>Click <strong>delete<\/strong>.<\/li>\n<\/ol>\n\n\n\n<p>The device’s record is removed from the Admin Portal.<\/p>\n\n\n\n<ul>\n<li>If the device has a status of <strong>Active, System Reporting<\/strong> when it\u2019s deleted from the Admin Portal, the JumpCloud agent and policies are also automatically removed.<\/li>\n\n\n\n<li>If the device has a status of <strong>Inactive, System Not Reporting<\/strong> when it\u2019s deleted from the Admin Portal, you need to log in to that device and manually remove the agent and policies.<\/li>\n\n\n\n<li>It can take up to two minutes for the agent and all associated files to be uninstalled from the local device.<\/li>\n<\/ul>\n\n\n\n<p><strong>Best Practice<\/strong>:<\/p>\n\n\n\n<p>If you’re removing the agent from a Windows device, verify the JumpCloud policies have been removed by running this command as administrator:<\/p>\n\n\n\n<div class=\"wp-block-cgb-code-block code-block\"><div class=\"code-block-snippet is-type-body-default\">\n<p>gpresult \/Scope Computer \/v<\/p>\n<\/div><\/div>\n\n\n\n<p>If they remain, you need to <a href=\"#manually-remove-jumpcloud-policies-from-a-windows-device\">manually remove policies from the Windows device<\/a>.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Using the JumpCloud API to Uninstall the Agent<\/h3>\n\n\n\n<p>Follow these steps to run a curl command to access the JumpCloud API and uninstall the agent. The JumpCloud API allows interaction with JumpCloud resources such as commands, devices, and users.<\/p>\n\n\n\n<p><strong>Considerations<\/strong>:<\/p>\n\n\n\n<ul>\n<li>Deleting a device through the JumpCloud API can take up to a minute to complete.<\/li>\n\n\n\n<li>When you remove the agent from a device, all associated policies, files, and directories are also removed. See the complete list in the <a href=\"https:\/\/jumpcloud.com\/support\/agent-compatibility-system-requirements-and-impacts\" target=\"_blank\" rel=\"noreferrer noopener\">Agent Compatibility, System Requirements, and Impacts<\/a> article.<\/li>\n\n\n\n<li>If you log on to a device and manually remove the agent first, a record remains in the Admin Portal. You can use these steps to remove only the system record if the system has a status of<strong> Inactive, System Not Reporting<\/strong>.<\/li>\n<\/ul>\n\n\n\n<p><strong>To uninstall the agent from the API<\/strong>:<\/p>\n\n\n\n<ol>\n<li>Review the API documentation to determine, based on your type of integration, which version of the JumpCloud API to use.<\/li>\n\n\n\n<li>Use the following sample request, replacing <strong>SystemID<\/strong> and <strong>API_KEY <\/strong>with the values specific to the device you want to stop managing. For definitions of keys, path parameters, and headers, review the API documentation for <a href=\"https:\/\/docs.jumpcloud.com\/api\/1.0\/index.html#tag\/Systems\/operation\/systems_delete\" target=\"_blank\" rel=\"noreferrer noopener\">Delete command<\/a>.<\/li>\n<\/ol>\n\n\n\n<div class=\"wp-block-cgb-code-block code-block\"><div class=\"code-block-snippet is-type-body-default\">\n<p>curl -X DELETE https:\/\/console.jumpcloud.com\/api\/systems\/{SystemID} \\<br>-H ‘Accept: application\/json’ \\<br>-H ‘Content-Type: application\/json’ \\<br>-H ‘x-api-key: {API_KEY}’<\/p>\n<\/div><\/div>\n\n\n\n<p>When the command completes successfully, the system’s record is removed from the Admin Portal.<\/p>\n\n\n\n<ul>\n<li>If the device has a status of <strong>Active, System Reporting<\/strong> when it\u2019s deleted from the Admin Portal, the JumpCloud agent and policies are also automatically removed.<\/li>\n\n\n\n<li>If the device has a status of <strong>Inactive, System Not Reporting<\/strong> when it\u2019s deleted from the Admin Portal, you need to log on to that system and manually remove the agent and policies.<\/li>\n<\/ul>\n\n\n\n<p><strong>Best Practice<\/strong>:<\/p>\n\n\n\n<ul>\n<li>If you\u2019re removing the agent from a Windows device, verify the JumpCloud policies have been removed by running this command as administrator:<\/li>\n<\/ul>\n\n\n\n<div class=\"wp-block-cgb-code-block code-block\"><div class=\"code-block-snippet is-type-body-default\">\n<p>gpresult \/Scope Computer \/v<\/p>\n<\/div><\/div>\n\n\n\n<p>If they remain, you must <a href=\"#manually-remove-jumpcloud-policies-from-a-windows-device\">manually remove policies from the Windows devices<\/a>.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Manually Remove the Agent from an Inactive Device<\/h3>\n\n\n\n<p>You should use these steps only if you want to uninstall the agent from a device that has a status of <strong>Inactive, System Not Reporting<\/strong> in the Admin Portal.<\/p>\n\n\n\n<p><strong>Considerations<\/strong>:<\/p>\n\n\n\n<ul>\n<li>If the device has a status of <strong>Active, System Reporting<\/strong>, you should remove all agent components automatically using either the Admin Portal or the JumpCloud API.<\/li>\n\n\n\n<li>If you log on to a device and manually remove the agent first, a record remains in the Admin Portal. You also need to remove the record using either the Admin Portal or the JumpCloud API.<\/li>\n<\/ul>\n\n\n\n<p><strong>To manually remove the agent<\/strong>:<br>Use the steps in the following table for the OS on your system.<\/p>\n\n\n\n<div class=\"wp-block-wpdatatables-wpdatatables-gutenberg-block\">\n<div class=\"wpdt-c row wpDataTableContainerSimpleTable wpDataTables wpDataTablesWrapper\n\"\n >\n <table id=\"wpdtSimpleTable-28\"\n style=\"border-collapse:collapse;\n border-spacing:1px;\"\n class=\"wpdtSimpleTable wpDataTable\"\n data-column=\"3\"\n data-rows=\"5\"\n data-wpID=\"28\"\n data-responsive=\"0\"\n data-has-header=\"1\">\n\n <thead> <tr class=\"wpdt-cell-row \" >\n <th class=\"wpdt-cell \"\n data-cell-id=\"A1\"\n data-col-index=\"0\"\n data-row-index=\"0\"\n style=\" width:33.333333333333%; padding:10px;\n \"\n >\n OS <\/th>\n <th class=\"wpdt-cell \"\n data-cell-id=\"B1\"\n data-col-index=\"1\"\n data-row-index=\"0\"\n style=\" width:33.333333333333%; padding:10px;\n \"\n >\n Uninstall Steps <\/th>\n <th class=\"wpdt-cell \"\n data-cell-id=\"C1\"\n data-col-index=\"2\"\n data-row-index=\"0\"\n style=\" width:33.333333333333%; padding:10px;\n \"\n >\n Notes <\/th>\n <\/tr>\n <tbody> <tr class=\"wpdt-cell-row \" >\n <td class=\"wpdt-cell \"\n data-cell-id=\"A2\"\n data-col-index=\"0\"\n data-row-index=\"1\"\n style=\" padding:10px;\n \"\n >\n Mac <\/td>\n <td class=\"wpdt-cell wpdt-align-left\"\n data-cell-id=\"B2\"\n data-col-index=\"1\"\n data-row-index=\"1\"\n style=\" padding:10px;\n \"\n >\n <div data-type-content=\"wpdt-html-content\">\n<ol>\n<li>Download the <a href=\"https:\/\/github.com\/TheJumpCloud\/support\/releases\/download\/mac_agent_uninstaller_v1.0.0\/remove_mac_agent.sh\">remove Mac agent script<\/a>.<\/li>\n<li>Run the script:\n<pre>sudo sh remove_mac_agent.sh<\/pre>\n<\/li>\n<li>Approve Terminal access when prompted.<\/li>\n<\/ol>\n<\/div> <\/td>\n <td class=\"wpdt-cell wpdt-align-left\"\n data-cell-id=\"C2\"\n data-col-index=\"2\"\n data-row-index=\"1\"\n style=\" padding:10px;\n \"\n >\n <div data-type-content=\"wpdt-html-content\"><p>You need an administrator password to run the sudo command.<\/p><\/div> <\/td>\n <\/tr>\n <tr class=\"wpdt-cell-row \" >\n <td class=\"wpdt-cell \"\n data-cell-id=\"A3\"\n data-col-index=\"0\"\n data-row-index=\"2\"\n style=\" padding:10px;\n \"\n >\n Windows <\/td>\n <td class=\"wpdt-cell wpdt-align-left\"\n data-cell-id=\"B3\"\n data-col-index=\"1\"\n data-row-index=\"2\"\n style=\" padding:10px;\n \"\n >\n <div data-type-content=\"wpdt-html-content\"><ol>\n<li>Open the <strong>Control Panel<\/strong>.<\/li>\n<li>Click <strong>Programs and Features<\/strong>.<\/li>\n<li>Click JumpCloud agent (\"JumpCloud v1.0\").<\/li>\n<li>Click <strong>Uninstall<\/strong>.<\/li>\n<\/ol><\/div> <\/td>\n <td class=\"wpdt-cell wpdt-align-left\"\n data-cell-id=\"C3\"\n data-col-index=\"2\"\n data-row-index=\"2\"\n style=\" padding:10px;\n \"\n >\n <div data-type-content=\"wpdt-html-content\">\n<p>For specific files, directories, and registry keys modified by the Windows Agent, see <a href=\"..\/support\/agent-compatibility-system-requirements-and-impacts#changes-made-to-your-windows-device-during-installation\">Changes Made to Your Windows Device During Installation<\/a>.<\/p>\n<p> <\/p>\n<\/div> <\/td>\n <\/tr>\n <tr class=\"wpdt-cell-row \" >\n <td class=\"wpdt-cell \"\n data-cell-id=\"A4\"\n data-col-index=\"0\"\n data-row-index=\"3\"\n style=\" padding:10px;\n \"\n >\n Debian\/Ubuntu <\/td>\n <td class=\"wpdt-cell wpdt-align-left\"\n data-cell-id=\"B4\"\n data-col-index=\"1\"\n data-row-index=\"3\"\n style=\" padding:10px;\n \"\n >\n <div data-type-content=\"wpdt-html-content\"><ol>\n<li>Log on to the device as an administrator.<\/li>\n<li>Open a command prompt.<\/li>\n<li>At the prompt, type:<br \/>\n<pre>service jcagent stop<br \/>apt-get remove jcagent<br \/>rm -rf \/opt\/jc<\/pre>\n<\/li>\n<\/ol><\/div> <\/td>\n <td class=\"wpdt-cell \"\n data-cell-id=\"C4\"\n data-col-index=\"2\"\n data-row-index=\"3\"\n style=\" padding:10px;\n \"\n >\n - <\/td>\n <\/tr>\n <tr class=\"wpdt-cell-row \" >\n <td class=\"wpdt-cell \"\n data-cell-id=\"A5\"\n data-col-index=\"0\"\n data-row-index=\"4\"\n style=\" padding:10px;\n \"\n >\n Amazon\/CentOS\/RHEL <\/td>\n <td class=\"wpdt-cell wpdt-align-left\"\n data-cell-id=\"B5\"\n data-col-index=\"1\"\n data-row-index=\"4\"\n style=\" padding:10px;\n \"\n >\n <div data-type-content=\"wpdt-html-content\"><ol>\n<li>Log on to the device as an administrator.<\/li>\n<li>Open a command prompt.<\/li>\n<li>At the prompt, type:<br \/>\n<pre>service jcagent stop<br \/>yum remove jcagent<br \/>rm -rf \/opt\/jc <\/pre>\n<\/li>\n<\/ol><\/div> <\/td>\n <td class=\"wpdt-cell \"\n data-cell-id=\"C5\"\n data-col-index=\"2\"\n data-row-index=\"4\"\n style=\" padding:10px;\n \"\n >\n - <\/td>\n <\/tr>\n <\/table>\n<\/div><\/div>\n\n\n\n<h3 class=\"wp-block-heading\">Manually Remove JumpCloud Policies from a Windows Device<\/h3>\n\n\n\n<p>Follow these steps only after you have uninstalled the agent. If the JumpCloud policies weren’t automatically removed, you can manually remove them from the Windows device.<\/p>\n\n\n\n<div class=\"wp-block-cgb-notification-card-wysiwyg notification-card warning\"><div class=\"notification-card-content\"><div class=\"notification-card-icon\"><p><img decoding=\"async\" src=\"\/wp-content\/themes\/jumpcloud\/assets\/images\/gutenberg-blocks\/warning-icon.png\" \/><\/p><\/div><div class=\"notification-card-copy is-type-body-default\"><div><strong class=\"notification-card-type\">Warning:<\/strong> \n<p>When you clear the device’s local Group Policy cache, you’re removing not only JumpCloud policies, but all other policies that have been applied, including Windows User and Group policies.<\/p>\n <\/div><\/div><\/div><\/div>\n\n\n\n<p>In these steps, you’ll use the <strong>secedit<\/strong> command to clear the system’s local Group Policy cache. The <strong>secedit<\/strong> command lets you configure the current device’s security settings stored in a database.<\/p>\n\n\n\n<p><strong>To remove JumpCloud policies from a Windows device<\/strong>:<\/p>\n\n\n\n<ol>\n<li>Log in to the device as an administrator.<\/li>\n\n\n\n<li>Verify JumpCloud policies remain after an uninstallation by running this command:<\/li>\n<\/ol>\n\n\n\n<div class=\"wp-block-cgb-code-block code-block\"><div class=\"code-block-snippet is-type-body-default\">\n<p>gpresult \/Scope Computer \/v<\/p>\n<\/div><\/div>\n\n\n\n<ol start=\"3\">\n<li>If group policies are listed, open a PowerShell terminal.<\/li>\n\n\n\n<li>At the prompt, type this command:<\/li>\n<\/ol>\n\n\n\n<div class=\"wp-block-cgb-code-block code-block\"><div class=\"code-block-snippet is-type-body-default\">\n<p>secedit \/configure \/cfg $env:windir\\inf\\defltbase.inf \/db defltbase.sdb \/verbose<br>Remove-Item $env:windir\\System32\\GroupPolicyUsers<br>Remove-Item $env:windir\\System32\\GroupPolicy<br>gpupdate \/force<\/p>\n<\/div><\/div>\n\n\n\n<ol start=\"5\">\n<li>After you run this command, you need to reapply any Windows User and Group policies that are required by your organization.<\/li>\n<\/ol>\n\n\n\n<h3 class=\"wp-block-heading\">Device Status After Removing JumpCloud<\/h3>\n\n\n\n<p>When you remove JumpCloud from a device, either by deleting the device in the Admin Portal, or by manually removing the agent from the device, the following will occur:<\/p>\n\n\n\n<ol>\n<li>The JumpCloud agent will be removed from the device.<\/li>\n\n\n\n<li>All users on the device will remain unaffected regardless of whether they were provisioned by JumpCloud or were pre-existing and taken over by JumpCloud. <\/li>\n\n\n\n<li>All user data and permissions on the device remain as is.<\/li>\n\n\n\n<li>Any commands set up to run on that device via JumpCloud Commands will no longer run, regardless of how those commands are launched (this means you\u2019ll need to move any scheduled commands manually in cron or another scheduling tool).<\/li>\n<\/ol>\n\n\n\n<h4 class=\"wp-block-heading\">Your Data In JumpCloud<\/h4>\n\n\n\n<ol>\n<li>Your account will remain intact, should you wish to use JumpCloud in the future.<\/li>\n\n\n\n<li>If you remove enough users to get below 11, your charges will drop to $0 and your account will continue as is going forward.<\/li>\n\n\n\n<li>Any undeleted devices that go offline without being removed from the JumpCloud Admin Portal will remain in the Portal indefinitely, or until JumpCloud chooses to delete them.<\/li>\n<\/ol>\n","protected":false},"excerpt":{"rendered":"<p>This article covers the manual ways to install or uninstall the JumpCloud Agent via the JumpCloud Admin Portal on various […]<\/p>\n","protected":false},"author":206,"featured_media":0,"template":"","meta":{"_acf_changed":false,"_oasis_is_in_workflow":0,"_oasis_original":0,"_oasis_task_priority":"","inline_featured_image":false,"footnotes":""},"support_category":[2923,2852],"support_tag":[],"coauthors":[2842],"acf":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO Premium plugin v22.9 (Yoast SEO v22.9) - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>Install or Uninstall the JumpCloud Agent - JumpCloud<\/title>\n<meta name=\"description\" content=\"Learn how to install the JumpCloud agent across your fleet of devices to manage Linux, Mac, and Windows devices in JumpCloud.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/jumpcloud.com\/support\/install-the-agent\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Install or Uninstall the JumpCloud Agent\" \/>\n<meta property=\"og:description\" content=\"Browse the JumpCloud Help Center by category, search for a specific topic, or check out our featured articles.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/jumpcloud.com\/support\/install-the-agent\" \/>\n<meta property=\"og:site_name\" content=\"JumpCloud\" \/>\n<meta property=\"article:modified_time\" content=\"2024-12-11T13:01:54+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/fast.wistia.com\/embed\/medias\/yatcyaho3j\/swatch\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"8 minutes\" \/>\n\t<meta name=\"twitter:label2\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data2\" content=\"pamkellman\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/jumpcloud.com\/support\/install-the-agent\",\"url\":\"https:\/\/jumpcloud.com\/support\/install-the-agent\",\"name\":\"Install or Uninstall the JumpCloud Agent - JumpCloud\",\"isPartOf\":{\"@id\":\"https:\/\/jumpcloud.com\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/jumpcloud.com\/support\/install-the-agent#primaryimage\"},\"image\":{\"@id\":\"https:\/\/jumpcloud.com\/support\/install-the-agent#primaryimage\"},\"thumbnailUrl\":\"https:\/\/fast.wistia.com\/embed\/medias\/yatcyaho3j\/swatch\",\"datePublished\":\"2023-06-05T17:12:17+00:00\",\"dateModified\":\"2024-12-11T13:01:54+00:00\",\"description\":\"Learn how to install the JumpCloud agent across your fleet of devices to manage Linux, Mac, and Windows devices in JumpCloud.\",\"breadcrumb\":{\"@id\":\"https:\/\/jumpcloud.com\/support\/install-the-agent#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/jumpcloud.com\/support\/install-the-agent\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/jumpcloud.com\/support\/install-the-agent#primaryimage\",\"url\":\"https:\/\/fast.wistia.com\/embed\/medias\/yatcyaho3j\/swatch\",\"contentUrl\":\"https:\/\/fast.wistia.com\/embed\/medias\/yatcyaho3j\/swatch\"},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/jumpcloud.com\/support\/install-the-agent#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/jumpcloud.com\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Support\",\"item\":\"https:\/\/jumpcloud.com\/support\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Install or Uninstall the JumpCloud Agent\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/jumpcloud.com\/#website\",\"url\":\"https:\/\/jumpcloud.com\/\",\"name\":\"JumpCloud\",\"description\":\"Daily insights on directory services, IAM, LDAP, identity security, SSO, system management (Mac, Windows, Linux), networking, and the cloud.\",\"publisher\":{\"@id\":\"https:\/\/jumpcloud.com\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/jumpcloud.com\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/jumpcloud.com\/#organization\",\"name\":\"JumpCloud\",\"url\":\"https:\/\/jumpcloud.com\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/jumpcloud.com\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/jumpcloud.com\/wp-content\/uploads\/2021\/01\/jc-logo-brand-2021.png\",\"contentUrl\":\"https:\/\/jumpcloud.com\/wp-content\/uploads\/2021\/01\/jc-logo-brand-2021.png\",\"width\":598,\"height\":101,\"caption\":\"JumpCloud\"},\"image\":{\"@id\":\"https:\/\/jumpcloud.com\/#\/schema\/logo\/image\/\"}}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"Install or Uninstall the JumpCloud Agent - JumpCloud","description":"Learn how to install the JumpCloud agent across your fleet of devices to manage Linux, Mac, and Windows devices in JumpCloud.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/jumpcloud.com\/support\/install-the-agent","og_locale":"en_US","og_type":"article","og_title":"Install or Uninstall the JumpCloud Agent","og_description":"Browse the JumpCloud Help Center by category, search for a specific topic, or check out our featured articles.","og_url":"https:\/\/jumpcloud.com\/support\/install-the-agent","og_site_name":"JumpCloud","article_modified_time":"2024-12-11T13:01:54+00:00","og_image":[{"url":"https:\/\/fast.wistia.com\/embed\/medias\/yatcyaho3j\/swatch"}],"twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"8 minutes","Written by":"pamkellman"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/jumpcloud.com\/support\/install-the-agent","url":"https:\/\/jumpcloud.com\/support\/install-the-agent","name":"Install or Uninstall the JumpCloud Agent - JumpCloud","isPartOf":{"@id":"https:\/\/jumpcloud.com\/#website"},"primaryImageOfPage":{"@id":"https:\/\/jumpcloud.com\/support\/install-the-agent#primaryimage"},"image":{"@id":"https:\/\/jumpcloud.com\/support\/install-the-agent#primaryimage"},"thumbnailUrl":"https:\/\/fast.wistia.com\/embed\/medias\/yatcyaho3j\/swatch","datePublished":"2023-06-05T17:12:17+00:00","dateModified":"2024-12-11T13:01:54+00:00","description":"Learn how to install the JumpCloud agent across your fleet of devices to manage Linux, Mac, and Windows devices in JumpCloud.","breadcrumb":{"@id":"https:\/\/jumpcloud.com\/support\/install-the-agent#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/jumpcloud.com\/support\/install-the-agent"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/jumpcloud.com\/support\/install-the-agent#primaryimage","url":"https:\/\/fast.wistia.com\/embed\/medias\/yatcyaho3j\/swatch","contentUrl":"https:\/\/fast.wistia.com\/embed\/medias\/yatcyaho3j\/swatch"},{"@type":"BreadcrumbList","@id":"https:\/\/jumpcloud.com\/support\/install-the-agent#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/jumpcloud.com\/"},{"@type":"ListItem","position":2,"name":"Support","item":"https:\/\/jumpcloud.com\/support"},{"@type":"ListItem","position":3,"name":"Install or Uninstall the JumpCloud Agent"}]},{"@type":"WebSite","@id":"https:\/\/jumpcloud.com\/#website","url":"https:\/\/jumpcloud.com\/","name":"JumpCloud","description":"Daily insights on directory services, IAM, LDAP, identity security, SSO, system management (Mac, Windows, Linux), networking, and the cloud.","publisher":{"@id":"https:\/\/jumpcloud.com\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/jumpcloud.com\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/jumpcloud.com\/#organization","name":"JumpCloud","url":"https:\/\/jumpcloud.com\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/jumpcloud.com\/#\/schema\/logo\/image\/","url":"https:\/\/jumpcloud.com\/wp-content\/uploads\/2021\/01\/jc-logo-brand-2021.png","contentUrl":"https:\/\/jumpcloud.com\/wp-content\/uploads\/2021\/01\/jc-logo-brand-2021.png","width":598,"height":101,"caption":"JumpCloud"},"image":{"@id":"https:\/\/jumpcloud.com\/#\/schema\/logo\/image\/"}}]}},"_links":{"self":[{"href":"https:\/\/jumpcloud.com\/wp-json\/wp\/v2\/support\/74720"}],"collection":[{"href":"https:\/\/jumpcloud.com\/wp-json\/wp\/v2\/support"}],"about":[{"href":"https:\/\/jumpcloud.com\/wp-json\/wp\/v2\/types\/support"}],"author":[{"embeddable":true,"href":"https:\/\/jumpcloud.com\/wp-json\/wp\/v2\/users\/206"}],"version-history":[{"count":3,"href":"https:\/\/jumpcloud.com\/wp-json\/wp\/v2\/support\/74720\/revisions"}],"predecessor-version":[{"id":118373,"href":"https:\/\/jumpcloud.com\/wp-json\/wp\/v2\/support\/74720\/revisions\/118373"}],"wp:attachment":[{"href":"https:\/\/jumpcloud.com\/wp-json\/wp\/v2\/media?parent=74720"}],"wp:term":[{"taxonomy":"support_category","embeddable":true,"href":"https:\/\/jumpcloud.com\/wp-json\/wp\/v2\/support_category?post=74720"},{"taxonomy":"support_tag","embeddable":true,"href":"https:\/\/jumpcloud.com\/wp-json\/wp\/v2\/support_tag?post=74720"},{"taxonomy":"author","embeddable":true,"href":"https:\/\/jumpcloud.com\/wp-json\/wp\/v2\/coauthors?post=74720"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}