Platform Installation with Helm

You need the following before deploying JFrog products with Helm charts.

📘

AWS EBS CSI Driver Required On EKS

When deploying a JFrog application on an AWS EKS cluster, the AWS EBS CSI Driver is required for dynamic volume provisioning. However, this driver is not included in the JFrog Helm Charts. For more information, see Store Kubernetes volumes with Amazon EBS.

For license requirements by product, see the License Matrix.

📘

If distribution.enabled: true

Verify entitlement in the License Matrix and prepare an external PostgreSQL distribution database. See Database and Third-Party Applications in Distribution.

flowchart TD
    A[Start] --> B[Check prerequisites: K8s, Helm, kubectl, StorageClass]
    B --> C[Add JFrog Helm repo]
    C --> D{Install path?}

    D -->|Evaluation| E[helm upgrade --install with chart defaults]
    D -->|Production| F[1 - Set up external PostgreSQL]

    F --> G[2 - Configure external filestore]
    G --> H[3 - Build customvalues.yaml]
    H --> I[4 - Create master-key and join-key secrets]
    I --> J[5 - Apply sizing profile]
    J --> K[6 - Run pre-install checklist]
    K --> L[helm upgrade --install with customvalues.yaml]

    E --> M[curl /router/api/v1/system/health]
    L --> M

    M --> N{HEALTHY?}
    N -->|No - wait 3 to 5 min| M
    N -->|Yes| O[Open UI - change admin password - complete Onboarding Wizard]
    O --> P[Done - tune and enable products]

Q: What is the minimum setup needed to install the JFrog Platform via Helm?

A: For evaluation, run helm upgrade --install jfrog-platform jfrog/jfrog-platform --namespace jfrog-platform --create-namespace. No configuration files are required — the chart defaults install Artifactory and Xray with a bundled PostgreSQL and local storage. Other products (Distribution, Catalog, Worker, Bridge) must be enabled via customvalues.yaml.

Q: How do I verify the JFrog Platform is running after a Helm install?

A: Run curl -f http://<JFROG_URL>/router/api/v1/system/health. A healthy response returns "status": "HEALTHY" for all services. If services appear unhealthy, wait 3–5 minutes — some services take time to initialize.

Q: Do I need an external database for a JFrog Platform Helm installation?

A: Not for evaluation — the chart includes a bundled PostgreSQL database. For production, configure an external PostgreSQL database before deploying. The bundled database is not suitable for production workloads. See JFrog Platform Helm chart — Advanced Configuration.

Q: What is the default admin password after a Helm install?

A: The default credentials are username admin and password password. Change the password immediately after the first login and complete the Onboarding Wizard.