Upgrading Distribution

JFrog Installation & Setup Documentation

Content Type
Installation & Setup

Subscription Information

This feature is supported on the Self-Hosted platform, with an Enterprise+ license.


The procedure to upgrade Distribution depends on your installation type. We strongly recommend reading through this page before proceeding with your upgrade.

Before you upgrade Distribution please refer to additional information on supported platforms, browsers and other requirements, and the system architecture.


Make sure to use the same upgrade method (RPM, Debian, Docker, etc.) as the one you initially used to install Distribution.


To ensure you can restore your Distribution and database in case you encounter any issues during the upgrade process, we strongly recommend that you make sure your system and database backups are up to date.

Upgrading to 2.x for the first time?

It is recommended that you first review what's new with the latest JFrog Platform. Review the breaking changes, deprecated features and more.What's New: Self-hosted

Artifactory and Distribution Pairing

The upgrade to the JFrog Platform requires mapping a source Artifactory to a single Distribution service. If you are creating and distributing release bundles from multiple source Artifactory instances and one Distribution instance, you will now need to deploy a Distribution service in every JPD that contains these source Artifactory instances. If your Mission Control instance is part of another JPD, you'll need to register it in the new Distribution instance. See details here.Connect Mission Control to Distribution

Upgrade Steps

The upgrade procedure involves the following main steps:

  1. Download Distribution (Docker Compose, RPM, Debian).

  2. Stop the Distribution service

  3. Install Distribution according to the installer distribution type.

  4. Check the Migration Log and review system.yaml to validate the migration was successful (only for upgrading from v2.x).

  5. Start the service using the start scripts or OS service management.

  6. Check the Distribution Log for the status of the service.

Default Home Directory / $JFROG_HOME

The default Distribution home directory is defined according to the installation type. For additional details see the Product Directory Structure page.

Note: This guide uses $JFROG_HOME to represent the JFrog root directory containing the deployed product.