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.

Overview

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.

Important

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

Warning

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 for the first time?

It is recommended that you first review changes, deprecated features and more.

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.