SUSE Support

Here When You Need Us

Recommendation against the use of --atomic flag for Rancher upgrades

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


Rancher 2.x 


Rancher upgrades using Helm


Do not use of the --atomic flag for Rancher upgrades using helm


Hypothetically, if the Rancher portion of the upgrade succeeds and the new Rancher Pods start running and making configuration state changes to the Rancher custom resources but then the helm upgrade fails on another part of the chart for any reason, a helm rollback is automatically performed due to the `--atomic` flag.

Because Helm rollbacks are not supported for Rancher you may end up in a broken state, with partially upgraded Rancher state, but with the older Rancher version running. 

For Rancher rollbacks in the case of a failed upgrade you should refer to the Rancher rollback documentation using the Rancher backup operator, or a cluster-level backup .

Additional Information


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:000021304
  • Creation Date: 20-Dec-2023
  • Modified Date:10-Jan-2024
    • 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.

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.

Open an Incident

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