KOTS: Steps to generate support bundle

Author: Sravya Bandari

Date: June 26, 2025

Audience: Everyone

Environmental details: Self-hosted customers

Summary

At Jama Software®, customer support may request a support bundle to efficiently diagnose, troubleshoot, and resolve technical issues reported by customers.

Support bundles enable you to collect and analyze troubleshooting data from customer environments, helping you diagnose problems with application deployments.

Typical Scenarios Where Support May Request a Bundle:

• Performance degradation or slow response times
• Errors during upgrades or installations
• Search indexing failures
• Relationship or project data inconsistencies
• LDAP or SSO integration issues
• Unexpected system behavior or crashes

Steps: Using the KOTS Admin UI

1. Log in to the admin console located at https://<IP or hostname>:8800 and go to the Troubleshoot tab.
2. Navigate to the KOTS admin console, then go to the troubleshooting bundle area. Select the “Analyse” button.
   
   
    
3. Please wait for the bundle to be generated, and then download it.

Steps: Using the CLI (with Internet Access)

You can run the following commands on the application server to generate the support bundle. The generated support bundle will be saved in the /root directory.

curl https://krew.sh/support-bundle | bash

kubectl support-bundle --load-cluster-specs --redactors=configmap/default/kotsadm-redact-spec/redact-spec,configmap/default/kotsadm-jama-k8s-redact-spec/redact-spec

Steps: Using the CLI (without Internet Access)

On the air-gapped instance, you can generate the support bundle using the command below. The bundle will be saved in the /root directory.

kubectl support-bundle secret/default/kotsadm-jama-k8s-supportbundle --redactors=configmap/default/kotsadm-redact-spec/redact-spec,configmap/default/kotsadm-jama-k8s-redact-spec/redact-spec

References

• Success Programs
• Success Catalog
• Datasheets
• Request a Solution Offering or Training from the Success Catalog

Please feel free to leave feedback in the comments below.