Products Upgrade

This section provides a guide on the different ways you can upgrade and configure JFrog products. JFrog supports in-place upgrades for minor version changes within the same major version (for example, Artifactory 7.84 to 7.90). Upgrades across major versions — such as from Artifactory 6.x to 7.x — require a dedicated migration procedure and cannot be done in-place.

Supported Installer Distribution Types

• Helm Chart
• Docker compose
• RPM
• Debian
• Linux Archive

Before starting the upgrade process, check the System Requirements.

Upgrade Flow

The following upgrade flow applies to all JFrog products:

1. Back up your existing data according to each product
2. Download the package to install (Standalone, RPM, Debian, Docker Compose, Helm)
3. Extract the package according to the installer distribution type (Extract, yum, wget, Docker Compose, Helm)
4. Migrate configuration from your current to the new environment, depending on the version you are upgrading from and to
5. Customize the product configuration (optional) by modifying the system YAML configuration file or setting environment variables
6. Start the service using the start scripts or OS service management

Before You Upgrade

When upgrading to Artifactory version 7.x from a previous major version (like 6.x), all other associated JFrog services must be upgraded to these compatible versions:

Artifactory 7.x will not work with any previous major versions of these services.

Additionally, none of these new versions — Xray 3.x, Distribution 2.x, and Mission Control 4.x — are compatible with Artifactory 6.x.

Frequently Asked Questions

❓Can I skip versions during an upgrade?

A: For minor version upgrades within Artifactory 7.x, you can upgrade directly to the latest version without intermediate steps. For major version upgrades (6.x to 7.x), follow the dedicated migration procedure — in-place upgrade is not supported. Always check the specific upgrade documentation for your installation method before proceeding.

❓Do I need to back up data before upgrading?

A: Yes. Always back up your database and filestore before any upgrade. The upgrade flow for all JFrog products requires backing up existing data as the first step, before downloading the new package.

❓What is the required upgrade order for Artifactory and Xray?

A: When upgrading to Artifactory 7.x from 6.x, all associated JFrog services must be upgraded to their compatible versions. Xray must be at 3.x, Distribution at 2.x, and Mission Control at 4.x. Artifactory 7.x is not compatible with Xray 2.x, Distribution 1.x, or Mission Control 3.x.