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.



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


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.

  • Document ID:000020217
  • Creation Date: 06-May-2021
  • Modified Date:06-May-2021
    • SUSE Rancher

< Back to Support Search

For questions or concerns with the SUSE Knowledgebase please contact: tidfeedback[at]

SUSE Support Forums

Get your questions answered by experienced Sys Ops or interact with other SUSE community experts.

Join Our Community

Support Resources

Learn how to get the most from the technical support you receive with your SUSE Subscription, Premium Support, Academic Program, or Partner Program.

SUSE Customer Support Quick Reference Guide SUSE Technical Support Handbook Update Advisories
Support FAQ

Open an Incident

Open an incident with SUSE Technical Support, manage your subscriptions, download patches, or manage user access.

Go to Customer Center