How to Restore the fleet-local namespace if it gets deleted accidently

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


Rancher 2.6.x and 2.7.x


The fleet-local namespace in the local cluster is showing a Pending state in the Rancher dashboard, or a Terminating state with kubectl.


Prepare to clean up the related helm chart, to let Rancher reinstall it again.

  • A kubeconfig for the Rancher (local) management cluster
  • The helm CLI
If you don't have a kubeconfig for the local cluster, the steps here can be used to retrieve one from the control plane node in the cluster.

1. Check that the kubeconfig is set for the correct cluster
export KUBECONFIG=/path/to/kubeconfig.yaml
kubectl get nodes
2. Delete the fleet chart using helm
helm uninstall fleet -n cattle-fleet-system
3. Perform a rollout restart of the Rancher deployment, this will trigger the recreation of fleet-local and its associated contents
kubectl rollout restart deploy/rancher -n cattle-system
Note, this may cause a small interruption for users as the websocket tunnel to Rancher will be re-established.

4. Check the fleet/fleet-crd apps are installed and active


Top Issue


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:000020994
  • Creation Date: 29-Mar-2023
  • Modified Date:29-Mar-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