# Upgrade Cloud Management Platform

> Upgrade a Cloud Management Platform instance

---

Site [llms.txt](/llms.txt)

---

The Cloud Management Platform (CMP) **upgraders** are distributed as `.tgz` archives, available from the **[CMP UI](#from-the-ui)** and the **[CloudBolt Support Portal](#from-the-support-portal)**.

The upgrader is designed to persist your customizations and configuration; however, new features may require post-upgrade configuration.

A CMP upgrade comprises the following steps:

1. **Download** the upgrader.
1. **Run** the upgrade script.
1. **Check** the version.

## Prerequisites

Before upgrading:

- Review the **[release notes](/docs/cmp/about/releases/)**
- Ensure you have sufficient **disk space** for the upgrade
- **Backup** your CMP instance and any external databases

<div class="alert alert-warning" role="alert">


**Upgrading to Release 2026.2.10 or later for the first time?** [Release 2026.2.10](/docs/cmp/about/releases/release-2026-2/#release-2026-2-10) introduced significant framework changes (Django 5.2, Python 3.12, DRF 3.15.2). Review **[Upgrading to Release 2026.2: Framework changes and compatibility](/docs/cmp/configure/administration/maintain/upgrade/release-2026-2/)** before proceeding.
</div>


<div class="alert alert-info" role="alert">


Upgrading CMP does not upgrade its PostgreSQL database. To move the database from PostgreSQL 14 to PostgreSQL 18, see [Upgrade to PostgreSQL 18](/docs/cmp/configure/administration/maintain/upgrade/postgresql-18/).
</div>


## Download the upgrader

Download the upgrader using one of the following methods.

### From the UI

1. Go to **All Admin**.
1. Select **Version & Upgrade Info**.
1. Select **Download X.X.X upgrader to Server**

### From the Support Portal

1. Download the **latest release's upgrader file** from the **[Support Portal](https://support.cloudbolt.io/cloudbolt/s/topic/0TO5c000001MolrGAC/releases)**.
1. Copy the upgrader to `/var/tmp` on your CMP instance.

## Run the upgrade script

<div class="alert alert-info" role="alert">


If using an external database, disable the local database service before upgrading the CMP instance: run `systemctl disable postgresql-14`, or `systemctl disable postgresql-18` on an instance installed with CMP 2026.3.97 or later.
</div>


Run the CMP upgrade script from the command line.

1. SSH into the CMP instance as `root`
1. Go to the `tmp` directory:

   ```bash
   cd /var/tmp
   ```

1. **Untar** the upgrader:

   ```bash
   tar xzf cloudbolt_upgrader_v<version-number>.tgz
   ```

1. Go to the `upgrader` directory:

   ```bash
   cd cloudbolt_upgrader*
   ```

1. Run the **upgrade script**:

   ```bash
   ./upgrade_cloudbolt.sh
   ```

## Check the version

Verify the upgraded CMP version.

1. Go to **Admin** > **Version & Upgrade Info**.
1. Under **Currently Installed**, review the **Version** number.

## Troubleshooting

If you encounter issues during the upgrade, SSH into the CMP instance as `root` and inspect the logs.

**[Contact CloudBolt Support](/docs/cmp/support/)** if you are unable to identify and resolve the issue.

---

Section pages:

- [Import and export utilities](/docs/cmp/configure/administration/maintain/upgrade/import-export-utilities/): Move files and directories between Cloud Management Platform (CMP) instances with the cb_export and cb_import utilities
- [Maintenance modes](/docs/cmp/configure/administration/maintain/upgrade/maintenance-modes/): Maintenance modes restrict who can use Cloud Management Platform (CMP) and whether jobs run while you maintain or upgrade it
- [Upgrade with high availability](/docs/cmp/configure/administration/maintain/upgrade/high-availability/): Upgrading a highly available Cloud Management Platform configuration
- [Upgrading to Release 2026.2](/docs/cmp/configure/administration/maintain/upgrade/release-2026-2/): Prepare for the Django 5.2, Python 3.12, and Django REST Framework (DRF) 3.15.2 upgrade in Release 2026.2.10, including deprecations, JWT token lifetime settings, XUI upgrade errors, and Python package compatibility
- [Upgrade to PostgreSQL 18](/docs/cmp/configure/administration/maintain/upgrade/postgresql-18/): Upgrade the database of an existing Cloud Management Platform (CMP) installation from PostgreSQL 14 to PostgreSQL 18
- [Upgrading to Release 2026.3](/docs/cmp/configure/administration/maintain/upgrade/release-2026-3/): Migrate custom templates, UI extensions, and JavaScript from Bootstrap 3 to Bootstrap 5 for Cloud Management Platform (CMP) Release 2026.3.51