Cloud customer?
 Upgrade in MyJFrog >

Search





Get Started

Welcome to the JFrog Platform Self-Hosted. This section will help you start your JFrog Platform Self-Hosted experience.

These quick links are designed to help you learn about the self-hosted subscriptions and features, onboard the platform with specifically designed onboarding guides, videos and the Onboarding Wizard for new users. If you are an existing user learn about what's new in the self-hosted solution.


Get started with the onboarding videos for JFrog ArtifactoryJFrog Xray, and JFrog Pipelines.


Page Contents


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 Mission Control 4.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. 

The new major versions of the JFrog Platform products are not backward compatible with previous major versions.

JFrog products should be installed in the following order:

  1. Install Artifactory
  2. Install Mission Control (Enterprise/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 Mission Control
  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. Install Distribution
  7. Install Pipelines

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

Products in purple are mandatory and products in black are optional depending on your organization needs.

Subscription Type

JFrog Products to Install

Artifactory OSS (Free)
  • JFrog Artifactory Open Source: Maven and Generic Package Manager Repository 
Artifactory CE (Free)
  • JFrog Artifactory Conan Edition: Conan C/C++ and Generic Package Manager Repository 
JFrog Container Registry (Free)
  • JFrog Container Registry (Powered by Artifactory): Docker, Helm and Generic Package Manager Repository 
Pro
  • JFrog Artifactory: Universal Package Manager Repository 
Pro X
  • JFrog Artifactory: Universal Package Manager Repository
  • JFrog Xray: Security and Compliance Scanning
Enterprise
  • JFrog Artifactory: Universal Package Manager Repository
  • JFrog Mission Control: Manage multiple JFrog services, manage licenses
  • JFrog Xray: Security and Compliance Scanning
Enterprise+
  • JFrog Artifactory: Universal Package Manager Repository
  • JFrog Mission Control: Manage multiple JFrog services, manage licenses, DevOps Insights
  • JFrog Xray: Security and Compliance Scanning
  • JFrog Pipelines: CI/CD pipeline orchestration 
  • JFrog Distribution: Global software distribution



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 Mission Control
  4. Upgrade Distribution

With the exception of Artifactory in HA mode, expect downtime for the products while upgrading to the new versions.


Quick Access

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

Copyright © 2020 JFrog Ltd.