Tips for finding Knowledge Articles

  • - Enter just a few key words related to your question or problem
  • - Add Key words to refine your search as necessary
  • - Do not use punctuation
  • - Search is not case sensitive
  • - Avoid non-descriptive filler words like "how", "the", "what", etc.
  • - If you do not find what you are looking for the first time,reduce the number of key words you enter and try searching again.
  • - Minimum supported Internet Explorer version is IE9
Home  >

KB-8377: How to update Centrify Agent for Mac

App Access Service ,   App Gateway Service ,   Mac & PC Management Service ,  

15 March,17 at 05:41 PM

Applies to: Centrify Identity Service

Our organization is using the Centrify Agent to enroll Mac computers into the cloud for remote management and we would like to update our systems to the most current release. What methods does Centrify provide to update the agent?

Centrify Agent versions do not currently support auto-update but users can perform manual updates on currently enrolled computers at any time that is convenient. As an alternate approach, Administrators can download the .dmg file and distribute to client computers using a custom script or software deployment solution.


How to check the current version of the agent:

1. Open the Centrify Agent from the Launchpad or Applications folder.
2. Select "Centrify Agent" and then "About Centrify Agent" from the menu bar.
3. The version information is displayed:

          User-added image

How to check if an updated agent  version is available:

To check for updated versions of the agent, perform the following steps:

1. Open the Centrify Agent from the Launchpad or Applications folder.
2. Select "Update" and then "Check for Updates" from the menu bar

          User-added image

3. If a new version is available, a prompt will be displayed. When the Update button is selected, the identity platform downloads it and replaces your existing Centrify Agent.

          User-added image

Note: The computer must be currently enrolled with Centrify to perform the update. Devices that are not enrolled will receive the following prompt:

          User-added image

How to manually download and install the agent:

You can download new versions of the Centrify Agent when updates become available. Newer versions offer the latest improvements in management capabilities. There are 2 different methods to download the agent depending on the policy options configured by an administrator. This may be useful for instances where the computer does not have internet connectivity and requires offline installation or if the update check using the menu option fails for any reason. 

Method 1

If you have configured policy options to permit OS X device enrollment, the Enable "Enroll your Mac" prompt at portal login drop-down menu appears within the policy settings. Select Yes to prompt users to enroll when they log in to the Centrify User Portal from an OS X device, No to not prompt users to enroll, or "--" (Not configured) to use the default setting. The default is No.

          User-added image

When users login to the Centrify portal, the following prompt is displayed:

          User-added image

Method 2

If you have not configured policy options to Enable "Enroll your Mac" prompt at portal login, follow the below steps to download and install the agent.

1. Login to the Centrify User Portal from the Mac computer
2. Select Devices from the top menu and then click the Add Devices button
3. Click the Enroll My Mac button to download the agent
4. Launch the downloaded file to start the installation.

          User-added image

or additional information not covered in this guide or troubleshooting assistance, please review Centrify Online Help or visit the Customer Portal at

Still have questions? Click here to log a technical support case, or collaborate with your peers in Centrify's Online Community.