How to install or upgrade to a specific Rancher v2.x version

Table of Contents


By default the installation and upgrade documentation references the installation of, or upgrade to, the most recently released latest or stable tagged version of Rancher. This article details how to install a specific version, both in a single node and high availability installation.

For details on the difference between the latest and stable releases please see the documentation on 'Choosing a Version'.

N.B. We strongly recommend you only run product releases tagged “Stable” in your production and any other business-critical environments. Any product release with the “Latest” tag should only be used for testing the latest releases."


Single Node Install

To install or upgrade to a specific Rancher version in a single node install, you can specify the exact version number of the image to run, rancher/rancher:vX.X.X, i.e.:

docker run -d --restart=unless-stopped \
  -p 80:80 -p 443:443 \

High Availability (HA) Install

To install or upgrade to a specific version in a High Availability install, you can specify the --version X.X.X parameter when running the helm install or helm upgrade command, i.e.:

helm install rancher-stable/rancher \
  --name rancher \
  --namespace cattle-system \
  --set \
  --version 2.2.2
Was this article helpful?
0 out of 0 found this helpful



Please sign in to leave a comment.