---
updatedAt: 2026-05-21T09:14:56.000Z
agentTools:
  siteIndex: https://docs.jfrog.com/llms.txt
  projectIndex: https://docs.jfrog.com/installation/llms.txt
---

# Distribution Upgrade

Upgrade Distribution using the same method as original install: Helm, Docker Compose, RPM, or Debian.

<Callout icon="📘" theme="info">
  **Subscription Information**

  This feature is supported on the **Self-Hosted** platform, with an **Enterprise+** license.
</Callout>

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, refer to additional information on supported [platforms, browsers, and other requirements](system-requirements), and the [system architecture](system-architecture).

<Callout icon="📘" theme="info">
  **Important**

  Use the same upgrade method (RPM, Debian, Docker, etc.) as the one you initially used to install Distribution.
</Callout>

<Callout icon="⚠️" theme="warning">
  **Warning**

  To ensure you can restore your Distribution and database if you encounter issues during the upgrade, we strongly recommend that your system and database backups are up to date.
</Callout>

<Callout icon="✅" theme="okay">
  **Upgrading for the first time?**

  We recommend reviewing changes, deprecated features, and more before upgrading for the first time.
</Callout>

<Cards columns={2}>
  <Card title="Distribution Upgrade from Version 2.x to 2.x" href="upgrading-from-distribution-version-2-x-to-2-x" icon="fa-solid fa-arrow-up">
    Upgrade JFrog Distribution from one 2.x version to another using Helm, Docker Compose, RPM, Debian, or Linux Archive with the JFrog installer script.
  </Card>
</Cards>

### Upgrade Steps

The upgrade procedure involves the following main steps:

1. **<a href="https://jfrog.com/download-jfrog-platform" target="_blank">Download Distribution</a>** (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.

<Callout icon="📘" theme="info">
  **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.
</Callout>

## Related Topics

* [Products Upgrade](upgrade)
* [Distribution Upgrade from Version 2.x to 2.x](upgrading-from-distribution-version-2-x-to-2-x)
* [Installing Distribution](installing-distribution)
* [System Requirements](system-requirements)
* [System Architecture](system-architecture)