---
title: Generate a Support Bundle
slug: install-10x/generate-a-support-bundle
docTags: 
createdAt: 2025-07-16T13:29:40.595Z
---

If you're having issues with the Swimlane Platform Installer (SPI), your Swimlane support representative will likely ask you to generate a support bundle to identify the diagnostics for your issue.

Support bundles contain logs from all relevant pods, as well as other useful information from your deployment.

## Airgapped Deployments

Use these instructions for an airgapped deployment.

Before you begin generating a support bundle you must first ensure that you have the support-bundle command installed.

### Install the Support-Bundle Command

If you have already installed the support-bundle command, you can skip these steps.

To install the support-bundle command:

From a computer that is connected to the internet run:

:::BlockQuote
curl -o support-bundle [https://krew.sh/support-bundle](https://krew.sh/support-bundle)
curl -o spec.yaml [https://kots.io](https://kots.io) -H 'User-agent\:Replicated\_Troubleshoot/v1beta1'
:::

Move the files to the server:

:::BlockQuote
scp support-bundle \<server>:/path/
scp spec.yaml \<server>:/path/
:::

Next, connect to the airgapped server and make the support-bundle file executable:

:::BlockQuote
chmod 777 support-bundle
:::

Execute the installer for support-bundle:

:::BlockQuote
./support-bundle
:::

Finally, generate the support bundle:

:::BlockQuote
kubectl support-bundle /path/to/spec.yaml
:::

A support bundle is created in the directory from which you ran the command:

:::BlockQuote
support-bundle-2021-01-19T17\_20\_56.tar.gz
:::

Give this support bundle to Swimlane support.

### Generating a Support Bundle with CLI (Airgap)

To generate a support bundle with CLI (Airgap):

1. Log in to SPI, and connect to the server.
2. Run this support-bundle command:

:::BlockQuote
kubectl support-bundle secret/default/kotsadm-swimlane-platform-supportbundle --redactors=configmap/default/kotsadm-redact-spec/redact-spec,configmap/default/kotsadm-swimlane-platform-redact-spec/redact-spec
:::

If this command throws the following error, it means that a support-bundle file has been saved in the directory from which the commands were run:

:::BlockQuote
$ kubectl support-bundle secret/default/kotsadm-swimlane-platform-supportbundle
 \* failed to run collector "run/ping-google": timeout
 \* Failed to upload support bundle: execute request: Put "https\://\<swimlane-url>:8800/api/v1/troubleshoot/1n7plYfeeXJCdYH31LhYACWdVun/xjt595pdcr6m6fvts8wnbpbltbms6hhb": dial tcp \[\::1]:8800: connect: connection refused
:::

1. The support bundle uploads to your Swimlane Platform Installer UI.
2. From the Swimlane Platform Installer UI, click Dashboard and then open the Troubleshoot tab.
3. On Troubleshoot, click **Download bundle**.
4. ::Image[]{src="https://api.archbee.com/api/optimize/511c8QBH-VHiwWnyzIwUb/9ZJhTqj_AvDIYfi0ysNrP_troubleshoot-download-bundle.png" size="46" width="1822" height="794" position="center" showCaption="false"}
5. Deliver the downloaded file to Swimlane support.

## Online Deployments

Use these instructions for an online deployment that is connected to the internet.

Before you begin generating a support bundle you must first ensure that you have the support-bundle command installed. See [Install the Support-Bundle Command](#) for details.

### Generating a Support Bundle with CLI (Online)

To generate a support bundle with CLI (Online):

1. Log in to SPI, and connect to the server.
2. Run this support-bundle command:

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

1. Generate the support bundle by running this command:

:::BlockQuote
&#x20;kubectl support-bundle secret/default/kotsadm-swimlane-platform-supportbundle
:::

If this command throws the following error, it means that a support-bundle file has been saved in the directory from which the commands were run:

:::BlockQuote
$ kubectl support-bundle secret/default/kotsadm-swimlane-platform-supportbundle
 \* failed to run collector "run/ping-google": timeout
 \* Failed to upload support bundle: execute request: Put "https\://\<swimlane-url>:8800/api/v1/troubleshoot/1n7plYfeeXJCdYH31LhYACWdVun/xjt595pdcr6m6fvts8wnbpbltbms6hhb": dial tcp \[\::1]:8800: connect: connection refused
:::

1. The support bundle uploads to your Swimlane Platform Installer UI.
2. From the Swimlane Platform Installer UI, click Dashboard and then open the Troubleshoot tab.
3. On Troubleshoot, click **Download bundle**.
4. ::Image[]{src="https://api.archbee.com/api/optimize/511c8QBH-VHiwWnyzIwUb/9ZJhTqj_AvDIYfi0ysNrP_troubleshoot-download-bundle.png" size="46" width="1822" height="794" position="center" showCaption="false"}
5. Deliver the downloaded file to Swimlane support.

## Generating a Support Bundle Through the SPI UI

Use these instructions to get a support bundle from the SPI UI.

1. Log in to the Swimlane Platform Installer UI.
2. From the Swimlane Platform Installer UI, click Dashboard and then open the Troubleshoot tab.
   If you do not have the support-bundle command, see [Install the Support-Bundle Command](#).
3. On the Troubleshoot tab, click **Analyze Swimlane**.
4. The SPI checks the deployment for issues. This may take some time. You will know when the process is finished once you receive an analysis overview.
5. To view the content of the support bundle, click the File Inspector tab.
6. To download the support bundle, click **Download bundle**.
7. Deliver the downloaded file to Swimlane support.

