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

Article Number: 000020217

Environment

Rancher v2.x

Situation

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.

Please reference the Rancher Upgrade Checklist, when planning upgrades, to ensure that a supported upgrade path is followed.

N.B. Rancher Prime users should install Rancher from the Prime repository. For other users, we would recommend that you only run product releases tagged “Stable” in your production and any other critical environments. Any product release with the “Latest” tag should only be used for testing the latest releases.

Resolution

Single Node Docker 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 \
  --privileged \
  rancher/rancher:latest  or rancher/rancher:v2.13.2

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 rancher-<CHART_REPO>/rancher \
  --namespace cattle-system \
  --set hostname=rancher.my.org \
  --set bootstrapPassword=admin \
  --version 2.13.2