---
updatedAt: 2026-07-15T14:00:09.000Z
agentTools:
  siteIndex: https://docs.jfrog.com/llms.txt
  projectIndex: https://docs.jfrog.com/installation/llms.txt
---

# License Configuration for Artifactory HA Helm Installation

Activate Artifactory HA by installing licenses via UI, REST API, or Kubernetes secrets during 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. </Callout>

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

<Callout icon="⚠️" theme="warning">
  ###

  **Warning**

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

### 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](/administration/reference/installlicense). The REST API uses `\n` for newlines in the license string.

### Option C: Using a Kubernetes Secret

Deploy the Artifactory license(s) as a <a href="https://kubernetes.io/docs/concepts/configuration/secret/" target="_blank">Kubernetes Secret</a>. 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
   ```

<Callout icon="❗️" theme="error">
  ###

  **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.
</Callout>

#### 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
   ```

## Related Topics

* [Artifactory High Availability](artifactory-high-availability)
* [Artifactory License Installation with Kubernetes Secrets](add-licenses-using-secrets)
* [Clustering Artifactory](clustering-artifactory)
* [High Availability](high-availability)
* [Helm Charts for Advanced Users](helm-charts-for-advanced-users)

<br />