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

This document (000020217) is provided subject to the disclaimer at the end of this document.

Environment

Rancher (All version)

Situation

Issue

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."

Resolution

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 \
  --privileged \
  rancher/rancher:latest  or rancher/rancher:v2.7.0

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.7.0

Disclaimer

This Support Knowledgebase provides a valuable tool for SUSE customers and parties interested in our products and solutions to acquire information, ideas and learn from one another. Materials are provided for informational, personal or non-commercial use within your organization and are presented "AS IS" WITHOUT WARRANTY OF ANY KIND.