Set Up JFrog Container Registry

Use this procedure to install the free, self-managed JFrog Container Registry (JCR) and complete first-run setup so you can push and pull Docker, OCI, Helm, Helm OCI, and Generic artifacts. JCR is JFrog Artifactory with install type jcr. Installation paths, service names, and log files use Artifactory names.

This topic covers the following tasks:

• Install JFrog Container Registry
• Complete First-Run Setup

For what this edition includes, see JFrog Container Registry and JFrog Container Registry Capabilities.

Install JFrog Container Registry

Download the JCR distribution and install it using the Artifactory instructions with install type jcr. Supported methods include Linux archive, RPM, Debian, Docker, Docker Compose, Windows archive, and Helm.

To install JFrog Container Registry:

1. Get the JCR package using one of the following options:

   • Open the JFrog Container Registry product page and download the self-managed package.
   • Pull the jfrog/artifactory-jcr image from the registry used in Install Artifactory using Docker Compose.

2. Install with type jcr using one of the following methods. In every command and archive name, replace the subscription placeholder with jcr, not pro or oss. For methods not shown here, see Installing Artifactory.

   • Docker Compose: Download the Compose archive.

     Shell

     curl -g -L -O -J 'https://releases.jfrog.io/artifactory/bintray-artifactory/org/artifactory/jcr/docker/jfrog-artifactory-jcr/<VERSION>/jfrog-artifactory-jcr-<VERSION>-compose.tar.gz'

     Where:

     • <VERSION>: The Artifactory version you are installing

     For example:

     Shell

     curl -g -L -O -J 'https://releases.jfrog.io/artifactory/bintray-artifactory/org/artifactory/jcr/docker/jfrog-artifactory-jcr/7.161.15/jfrog-artifactory-jcr-7.161.15-compose.tar.gz'

   • Helm: Add the JFrog Helm repository, then install the jfrog/artifactory-jcr chart. For more information, see Install JFrog Artifactory using Helm.

     Shell

     helm repo add jfrog https://charts.jfrog.io
     helm repo update
     helm upgrade --install jfrog-container-registry jfrog/artifactory-jcr \
       --namespace artifactory-jcr --create-namespace \
       --set artifactory.postgresql.auth.password=<POSTGRES_PASSWORD> \
       --set artifactory.nginx.generateSelfSignedCert=true

     Where:

     • <POSTGRES_PASSWORD>: The password for the bundled PostgreSQL user

     The generateSelfSignedCert=true flag is for development only. For production TLS, set artifactory.nginx.tlsSecretName as described in the Helm install topic.

3. Start the service using the start method for your installer, then confirm the UI loads at your JFrog URL.

You can upgrade JCR or move to Artifactory Pro using the same flow as Artifactory. For more information, see Upgrading Artifactory.

Complete First-Run Setup

The first time you log in, JCR runs the same onboarding wizard as Artifactory, with two differences: you do not paste a commercial license key, and default repositories are limited to Generic, Docker, OCI, Helm OCI, and Helm.

Prerequisite: JCR is installed and the service is running. The default login is username admin and password password.

To complete first-run setup:

1. Open the JCR UI and log in with the default admin credentials.

2. Reset the admin password when the wizard prompts you. Use a password of at least 8 characters that includes uppercase, lowercase, and a number.

3. Complete the remaining wizard steps that apply to self-managed JCR: EULA, optional newsletter, base URL, and optional default proxy.

   📘

   Note

   JCR does not use an Artifactory Pro license file. Skip license activation. License bucket and JFrog Xray steps apply to commercial installs of the JFrog Platform. For more information, see Onboarding Wizard.

4. On the repository step, select one or more of Docker, OCI, Helm, Helm OCI, and Generic. JCR creates default local, remote, and virtual repositories for each type you select.

5. Review the summary and click Finish.

You can create additional repositories of those package types later in the UI. Creating other package types is blocked.

Frequently Asked Questions

This section provides answers to frequently asked questions.

Related Topics

• Docker Repositories
• OCI Repositories
• Kubernetes Helm Chart Repositories
• Generic Repositories
• JFrog Container Registry Capabilities