SUSE Support

Here When You Need Us

Is it possible to migrate a Rancher launched Kubernetes cluster between Rancher instances?

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



Is it possible to migrate a Rancher launched Kubernetes cluster from one Rancher server instance to another, e.g. to launch a custom cluster using one Rancher server, and then at a later time, to migrate this to be managed instead via a different Rancher instance?


  • A Kubernetes cluster launched and managed by Rancher v2.x


No, it is not possible to migrate a cluster between Rancher server instances. A feature request for this is tracked in GitHub Issue #16471.

Currently, if you launch a Kubernetes cluster in one Rancher instance, then later attempt to use the imported cluster feature to import this cluster into another Rancher instance, you will lose any ability to add or remove nodes from the cluster, perform etcd backups or disaster recovery, or to edit any of the cluster configuration. We would therefore strongly recommend against this. Instead, we recommend performing regular Rancher server backups, so that you can recover the Rancher server cluster in a disaster recovery scenario, ensuring successful on-going management of downstream clusters launched by the server.


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:000020220
  • 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.

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.