How to manually update the Crowd license

Platform Notice: Data Center Only - This article only applies to Atlassian products on the Data Center platform.

Note that this KB was created for the Data Center version of the product. Data Center KBs for non-Data-Center-specific features may also work for Server versions of the product, however they have not been tested. Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.

*Except Fisheye and Crucible

Summary

If the license fails to update in Crowd administration, you can also update directly in the configuration file by performing the steps below. The license details for Crowd are stored in crowd.cfg.xml in the application's home directory.

Solution

  1. Shutdown Crowd

  2. Navigate to <crowd home dir>/shared/. See Finding your Crowd Home Directory, if this is unknown

  3. Create a backup of the crowd.cfg.xml file and edit with any text editor

  4. Look for the line: <property name="license"><property> and paste the new license between the property tags

  5. Save and close the crowd.cfg.xml file

  6. Start your instance and verify that the license is updated in the Crowd Administration panel

Updated on April 8, 2025

Still need help?

The Atlassian Community is here for you.