JFrog Platform Product Base Versions

The JFrog Platform represents a major architectural change that affects all JFrog products. These changes are not backward compatible with previous major versions. As such, new installations should use only the versions below and not mix them with previous major versions. Similarly, customers upgrading from the previous major versions will need to upgrade all products currently in use to the versions below.

• JFrog Artifactory 7.x
• JFrog Insight 1.x
• JFrog Xray 3.x
• JFrog Distribution 2.x
• JFrog Pipelines 1.x

Installing the JFrog Platform

This section will help you get started with the JFrog Platform installation initial steps and planning.

Before You Begin

In this section, you will find information to get you started with installing or upgrading whether you are a new user or an existing user to the JFrog Platform. Depending on your subscription type and organization's needs, you can install the complete set of JFrog products or start with JFrog Artifactory as the base. To learn about the JFrog supported subscriptions, see the JFrog offering.

To get started with a new installation, you'll need to know the following:

1. Your subscription type. If you don’t have an existing subscription, Start a Free Trial.
2. Your selected JFrog products to install.
3. Review the System Architecture  and System Requirements
4. Plan your new installation

Installing JFrog Products by Subscription Type

To use JFrog products, you'll need to first install JFrog Artifactory. Once installed, you can continue to install additional products according to your subscription type and organization needs. 

JFrog products should be installed in the following order:

1. Install Artifactory
2. Install Insight (Enterprise+ only)
3. Apply your JFrog License depending on your license type, you can:
• either deploy a license manually to Artifactory (using the onboarding wizard on initial startup)
• or use a license bucket after connecting Insight
4. Install Artifactory Edge node(s)  (optional)
   The installation process is identical to installing any other Artifactory instance.
5. Install Xray
• Trial License: upload it to your JPD as a separate file. Read more about the JFrog Xray trial.
6. Installing Distribution
   
   • Configure Distribution
7. Install Pipelines

Below are the products you have access to for each subscription. 

Upgrading to the JFrog Platform

The new major versions of the JFrog Platform products are not backward compatible with the previous major versions. Hence if you are currently using multiple products in the Platform, you will need to upgrade each of the products you are using. 

Before You Begin

To upgrade to JFrog Platform product versions, you’ll need to do the following:

1. Review the What's New? page for:
1. Breaking Changes 
2. Deprecated Features
3. Features not available in the initial JFrog Platform release
4. REST API Changes
2. Review the new System Architecture and System Requirements
3. Plan your upgrade.

 Before upgrading you should account for:

1. The health check endpoint will need to be changed
2. The reverse proxy configuration will need to be updated
3. If you are using a single Xray to handle multiple Artifactory instances, you will need to move to a 1:1 set up before upgrading.
4. If you are using a single Distribution to distribute from multiple source Artifactory instances, you will need to move to a 1:1 set up. 

Upgrading JFrog Products 

When you are ready to upgrade, note that Artifactory must be upgraded first, followed by any other connected product(s). 

JFrog products should be upgraded in the following order:

1. Upgrade Artifactory
2. Upgrade Xray
3. Upgrade Insight
4. Upgrade Distribution

Quick Access

Quickly access pages that will help you start using the JFrog Platform.