Single Node Upgrade - Air Gap
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 or from any tag containing alpha aren’t supported.
Upgrading An Air Gapped Rancher Server
Follow the directions in Air Gap Installation to pull the Docker images required for the new version of Rancher.
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
Result: Rancher is upgraded. Log back into Rancher to confirm that the upgrade succeeded.
Having Network Issues Following Upgrade?
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.