To upgrade an air gapped Rancher Server, update your private registry with the latest Docker images, and then run the upgrade command.


Upgrades to v2.0.7+ only: Starting in v2.0.7, Rancher introduced the system project, which is a project that’s automatically created to store important namespaces that Kubernetes needs to operate. During upgrade to v2.0.7+, Rancher expects these namespaces to be unassigned from all projects. Before beginning upgrade, check your system namespaces to make sure that they’re unassigned to prevent cluster networking issues.

Upgrades to v2.2.0 only: mirror system-charts repository and configure Rancher
Starting in v2.2.0, Rancher introduced the System Charts repository which contains all the catalog items required for features such as monitoring, logging, alerting and global DNS. To be able to use these features in an air gap install, you will need to mirror the system-charts repository locally and configure Rancher to use that repository. Please follow the instructions to configure Rancher system charts.


Upgrades to or from any tag containing alpha aren’t supported.

Upgrading An Air Gapped Rancher Server

  1. Follow the directions in Air Gap Installation to pull the Docker images required for the new version of Rancher.

  2. Follow the directions in Single Node Upgrade to complete upgrade of your air gapped Rancher Server.

    Note: While completing Single Node Upgrade, prepend your private registry URL to the image when running the docker run command.

    Example: <>/rancher/rancher:latest

Result: Rancher is upgraded. Log back into Rancher to confirm that the upgrade succeeded.

Having Network Issues Following Upgrade?

See Restoring Cluster Networking.

Rolling Back

If your upgrade does not complete successfully, you can roll Rancher Server and its data back to its last healthy state. For more information, see Single Node Rollback.