ARTIFACTORY: Managing licenses

Adi Malca
2022-06-10 06:49

How to update licenses in a HA cluster if it is not visible in the UI?

How to update licenses in a HA cluster if it is not visible in the UI?
1. Use this REST API call
2. Update license key via values.yaml and Helm:

  • Use the copyOnEveryStartup feature mentioned in the values.yaml file, and you can refer to this wiki page for steps.
  • Exec to one of the pods and manually copy artifactory.cluster.license with the new keys from /artifactory_bootstrap/ to /opt/jfrog/artifactory/var/etc/artifactory/

How to upgrade a license from Pro to Enterprise and to E+?

To upgrade your license from pro to E or E+, you can replace the licenses in the UI under the Administration tab -> License -> Licenses. It is also possible to perform it by using this REST API command.

In addition, it is possible to edit the artifactory.lic file under /opt/jfrog/artifactory/var/etc/artifactory

If a License Bucket is being used, you can first add the new bucket, then remove the old one. The new licenses will be distributed automatically.

How to Apply a License bucket after Artifactory installation?

Drop the json file or paste the URL in the license box during the onboarding process. 

If you have an existing bucket and would like to apply licenses to a different installation (This will require MC):

  1. Split the existing bucket.  
  2. After installing Artifactory, access the UI and move forward with the onboarding pop tab.
  3. When reaching the license step, click the ‘x’
  4. Go to the Administration tab -> Licenses -> Licenses buckets
  5. Add the bucket using the file and the key.

How to release licenses from a split bucket?

Shut down the Artifactory instances that are associated with the licenses in the split bucket, then delete the split
bucket, the freed licenses will be added back to the main bucket.

User-added image

How to check the type of licenses that are used?

Once the licenses are applied, you can check the license type at the bottom right corner of the Artifactory

User-added image

Will switching licenses via the UI and file during Running time impact Artifactory?

No, and a restart is not needed.

Would we require a new license when we upgrade to the latest?

Upgrading Artifactory does not require changing the license. The only requirement is having a valid license.

How many active Project-based management is it possible to have with each license?

According to the JFrog pricing page it is possible to have 30 active Project-based management for Enterprise license, meaning in each Artifactory stand-alone instance or HA cluster can have 30 active Project-based management at a time.

For E+ license, it can be 300.

How to switch from a plain text license to a bucket license?

  1. Set up a license bucket according to the wiki page.

  2. Remove the plain text license via the UI.

  3. Attach licenses from the bucket license to the Artifactory instances.

How to activate Xray license?

If you have purchased the following licenses: "Pro X", "Enterprise X", "Enterprise +", the Xray license is already bundled in the Artifactory licenses. After installing Xray and integrating it with Artifactory it will be active and no further action is required. If you have purchased other licenses and received an "Xray Trail License", the licenses should be placed under the Administration Tab -> licenses -> Xray Trail Licenses tab, then install Xray and integrate it with Artifactory.

How to extract licenses from a license bucket:

Generally, it is recommended to install Mission Control to use a bucket license, although, in case of Mission Control is not installed, it is possible to extract the licenses with the following steps:

1. Download a Bucket license (JSON file). In this example, it is 123456789.json.
2. Execute the following decryption command and use the Bucket unlock key as "aes-256-cbc decryption password".

$ openssl aes-256-cbc -d -md md5 -in 123456789.json
enter aes-256-cbc decryption password:

3. The values of the "key" key are the decrypted licenses. You might need to remove a new line character(s) from it ("rn") before using the keys.

Is it possible to have Artifactory and Edge nodes in the same HA cluster?


How to switch from Enterprise/Enterpeise+ licenses to edge?

Replace the licenses via the UI or via the licenses file, then restart the Application.

How to move a license from one environment to the other?

1. Shutdown a node from the cluster (if you are not using 'affinity' make sure to shut down a member node)
2. In the UI, confirm that the license is marked as "Not in use".
3. Remove the license from the artifactory.cluster.licenses 
4. Place it in the new environment and start the new application.

Does Artifactory need Internet access to activate a license?


Do licenses that were generated for Artifactory version 5 and below will work on version 7.x?

No, if you have licenses for Artifactory version 4.x and would like to upgrade to version 7.x, you will need to acquire new licenses.

Why is the license expiration banner is present after placing a new license?

After placing a new license in the UI or attaching a new license from a bucket, it is possible that the banner with the message "Your Artifactory … license has expired." will still appear. This can be due to the old license being present in the artifactory.lic or artifactory.cluster.liceses file.

In order to resolve this behavior navigate to the file under:


open the file and remove the old license, after saving the file refresh the page in the browser.