How to recreate rancher-webhook-tls secret if incorrectly deleted

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


Rancher 2.5.8 or higher, incorrectly deleted rancher-webhook-tls secret instead of cattle-webhook-tls secret


The rancher-webhook-tls is expired on the local rancher cluster. 
After following the documentation to renew the certificate, the rancher-webhook pods cannot start. 


Trigger recreation of the rancher-webhook-tls secret:

1. Remove validating and mutating webhooks, as well as the webhook-service:
kubectl delete mutatingwebhookconfigurations 
kubectl delete validatingwebhookconfigurations
kubectl -n cattle-system delete service webhook-service

2. Navigate to Apps & Marketplace in the local cluster Explorer, Installed Apps, and perform an 'upgrade'
    of rancher-webhook to trigger the recreation of deleted resources and a new rancher-webhook-tls
    certificate secret.


Unintentionally deletion of rancher-webhook-tls secret instead of cattle-webhook-tls secret


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:000020699
  • Creation Date: 15-Jul-2022
  • Modified Date:31-Aug-2022
    • 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