Cloud customer?
Start for Free >
Upgrade in MyJFrog >
What's New in Cloud >



The Rancher Catalog Helm Chart allows Rancher users to deploy a JFrog Container Registry with a few keystrokes. The chart is available via the official Rancher Charts and can be deployed to any cluster managed via Rancher.


  • Rancher 2.x+
  • A Kubernetes cluster under Rancher management
Page Contents

Setting Up the JFrog Container Registry Rancher Helm Chart

  1. From the UI, go to Apps | Launch.
  2. Search for or select artifactory-jcr from the catalog.
  3. Enter a name and select the target project.
  4. Under the Services and Load Balancing, configure how you choose to expose the web application.
  5. Under the Artifactory Storage, set Enable Persistent Storage for Artifactory to True and configure your preferred filestore method:
    • File-system: Write to a locally mounted volume.
    • Google Storage: Write to Google Cloud Storage. You must set this up in advance and provide the details to access it here.
    • AWS S3: Write to AWS S3. You must set this up in advance and provide the details to access it here.
  6. Under the Database Settings, set Enable PostgreSQL and set Enable Persistent Storage for PostgreSQL to True.
  7. Select Show Advanced Configuration to configure settings such as CPU/Memory and to change the master key. (Optional).
  8.  Select Launch.

Upgrading JFrog Container Registry in the Rancher Catalog Helm Chart

The upgrade is only supported from 6.x to 6.x and 7.x to 7.x with an expected small downtime window. To upgrade, you need to manually edit the workloads.

  1. In Rancher UI, go to the project i.e. global | your cluster | project name (usually default)
  2. Select Apps.

    Do not select the 'Upgrade available' button in 'Apps'. You will lose all your data!

  3. Select your app.

    Each primary node and nginx is updated. Each workload is upgraded by changing the Docker image.

  4. Select three vertical dots to the right of the primary node and select  View | Edit YAML
    Rancher displays a text editor.
  5.  Search and replace all occurrences of old jfrog container registry tag (e.g. 7.3.2) with the version you want to upgrade to (e.g. 7.6.3).
  6. Select Save.
  7. Wait for primary node to turn green in Rancher UI. You can also watch status of various nodes in artifactory UI under Settings | Monitoring | Service Status
  8. Repeat steps 4-6 for nginx.
  9. Log into Artifactory and verify that all the nodes are now in the correct version of the UI | Administration | Monitoring | Service Status.
  • No labels
Copyright © 2022 JFrog Ltd.