Can I move from self-managed Rancher to Rancher Prime Hosted?

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


Yes, we can do a one time migration of your entire self-hosted Rancher Manager into the Rancher Prime Hosted service. Requirements for migration are:
  1. You must be running the latest stable version of Rancher (currently v2.7.6) for at least one week.
  2. Rancher cluster must be running Kubernetes v1.23 or higher for at least one week.
  3. All managed/downstream clusters must be running Kubernetes v1.23 or higher for at least one week.
  4. Have a kubeconfig file for all your managed (downstream) Kubernetes clusters. The kubeconfig file should point directly to the cluster’s kube-apiserver endpoint and not to Rancher. For RKE clusters, see Authorized Cluster Endpoint for setup.
  5. Authentication integration must be with a public endpoint that Rancher Prime Hosted can reach.
  6. Global and cluster catalogs must have a public endpoint that Rancher Prime Hosted can reach.
  7. Clusters provisioned using the vSphere node driver cannot be managed unless the vSphere API endpoint is made available to Rancher Prime Hosted.
  8. All downstream/managed clusters must have outbound Internet access over port 443, or at least outbound access to Rancher Prime Hosted.
  9. You must provide the output of Helm Chart values used to install Rancher: helm get values -n cattle-system rancher > rancher-values.yaml
  10. You must provide a copy of the system summary report for your Rancher environment. See this article for instructions.

To get started on migrating to Rancher Prime Hosted, open a support case on our support portal.


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:000020040
  • Creation Date: 05-Sep-2023
  • Modified Date:05-Sep-2023
    • 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