License Configuration for Artifactory HA Helm Installation

To activate Artifactory HA, install an appropriate license.

There are three ways to manage the licenses:

• Artifactory UI
• Rest API
• Kubernetes Secret

📘

Specifying multiple licenses

Whether using the Artifactory UI, REST API, or the artifactory.cluster.license file, separate licenses with a newline.

The Artifactory UI is the easiest and recommended method. The Kubernetes Secret and REST API methods are better suited for automation and advanced users.

⚠️

Warning

Use only one of these methods. Switching between them while a cluster is running may disable the Artifactory HA cluster.

Option A: Using Artifactory UI

Once the primary cluster is running, open the Artifactory UI and insert the license(s).

Enter all licenses at once, with each license separated by a newline. If you add them one at a time, you may be redirected to a node without a license and the UI will not load for that node.

Option B: Using Rest API

Add licenses via REST API. The REST API uses \n for newlines in the license string.

Option C: Using a Kubernetes Secret

Deploy the Artifactory license(s) as a Kubernetes Secret. Prepare a text file containing the license(s). If adding multiple licenses, include them in the same file with two blank lines between each license block.

1. Create the Kubernetes secret from the local license file art.lic.

   Bash

   kubectl create secret generic artifactory-cluster-license --from-file=./art.lic

2. Create a license-values.yaml.

   YAML

   artifactory:
     license:
       secret: artifactory-cluster-license
       dataKey: art.lic

3. Install with the license-values.yaml.

   Run the following command for JFrog Platform.

   Bash

   helm upgrade --install jfrog-platform --namespace jfrog-platform --create-namespace jfrog/jfrog-platform -f license-values.yaml

   Run the following command for Artifactory.

   Bash

   helm upgrade --install artifactory --set artifactory.license.secret=artifactory-cluster-license,artifactory.license.dataKey=artifactory.lic --namespace artifactory jfrog/artifactory

❗️

Important

This method applies to initial deployment only. Once Artifactory is deployed, stop passing these parameters — the license is already persisted in Artifactory's storage and further values are ignored. Update the license via the Artifactory UI or REST API.

Create the Kubernetes Secret as Part of the Helm Release

1. Create a license-values.yaml.

   YAML

   artifactory:
     license:
       licenseKey: |-
         <LICENSE_KEY1>
   
   
         <LICENSE_KEY2>
   
   
         <LICENSE_KEY3>

2. Install with the license-values.yaml.

   Bash

   helm upgrade --install jfrog-platform --namespace jfrog-platform --create-namespace jfrog/jfrog-platform -f license-values.yaml