# I want to create an airgap installer bundle

**URL:** <https://community.replicated.com/t/i-want-to-create-an-airgap-installer-bundle/1612>\
**Category:** How do I?\
**Tags:** kots, kurl, kubernetes-installer\
**Created:** [March 30, 2026, 10:06pm UTC](https://community.replicated.com/t/i-want-to-create-an-airgap-installer-bundle/1612 "2026-03-30T22:06:50Z")\
**Posts on this page:** 8\
**Page:** 1

<div class="post-metadata">

**Author:** ![lepome](https://yyz2.discourse-cdn.com/flex030/user_avatar/community.replicated.com/lepome/32/780_2.png) [@lepome](https://community.replicated.com/u/lepome)\
**Post date:** [March 30, 2026, 10:06pm UTC](https://community.replicated.com/t/i-want-to-create-an-airgap-installer-bundle/1612/1 "2026-03-30T22:06:50Z")

</div>

I have generated an installer url according to the document here: [https://kurl.sh/docs/create-installer/creating-an-installer-api](https://kurl.sh/docs/create-installer/creating-an-installer-api) but I want to turn that into an airgap bundle such as would be available from [https://kurl.sh/aeb67a7](https://kurl.sh/aeb67a7).

My URL is `https://kurl.sh/2b60ce1` and it works in a command like this for an online instance:  
`curl -sSL ``https://kurl.sh/2b60ce1`` | sudo bash -s app-version-label=1.13.3`

But I also want to be able to install onto an airgapped instance, and I don’t know how to build an airgap bundle for the installer outside of a channel.

(Long story…I’m not a developer–I’m support and the released installers don’t include a specific version of the base kURL installer ([Releases · replicatedhq/kURL · GitHub](https://github.com/replicatedhq/kURL/releases)))

---

<div class="post-metadata">

**Author:** ![Alex\_Parker](https://yyz2.discourse-cdn.com/flex030/user_avatar/community.replicated.com/alex_parker/32/777_2.png) [@Alex\_Parker](https://community.replicated.com/u/Alex_Parker)\
**Post date:** [March 31, 2026, 1:49pm UTC](https://community.replicated.com/t/i-want-to-create-an-airgap-installer-bundle/1612/2 "2026-03-31T13:49:08Z")

</div>

Hello. Do you just want to download the air gap bundle for your kURL installer? If so, you can do that at the URL you posted. If you click [https://kurl.sh/aeb67a7](https://kurl.sh/aeb67a7), you’ll see instructions on how to download and install with an air gap bundle.

If you’re looking for something different, let me know.

---

<div class="post-metadata">

**Author:** ![lepome](https://yyz2.discourse-cdn.com/flex030/user_avatar/community.replicated.com/lepome/32/780_2.png) [@lepome](https://community.replicated.com/u/lepome)\
**Post date:** [March 31, 2026, 3:01pm UTC](https://community.replicated.com/t/i-want-to-create-an-airgap-installer-bundle/1612/3 "2026-03-31T15:01:10Z")

</div>

You’d think so, but that doesn’t work.

---

<div class="post-metadata">

**Author:** ![lepome](https://yyz2.discourse-cdn.com/flex030/user_avatar/community.replicated.com/lepome/32/780_2.png) [@lepome](https://community.replicated.com/u/lepome)\
**Post date:** [April 23, 2026, 11:33pm UTC](https://community.replicated.com/t/i-want-to-create-an-airgap-installer-bundle/1612/4 "2026-04-23T23:33:44Z")

</div>

When I go to the URL that includes the correct parameters, `https://kurl.sh/2b60ce1` and click on the Download airgap bundle button, I see Internal Server Error. (I tried in other browsers, but that doesn’t matter: Firefox, Chrome, and Edge)

 ![image](https://canada1.discourse-cdn.com/flex030/uploads/replicated/original/1X/07cb9b9eb1d1a4c0a099e041db40a1823b550c5e.png)

---

<div class="post-metadata">

**Author:** ![GerardNguyen](https://yyz2.discourse-cdn.com/flex030/user_avatar/community.replicated.com/gerardnguyen/32/828_2.png) [@GerardNguyen](https://community.replicated.com/u/GerardNguyen)\
**Post date:** [April 24, 2026, 12:30am UTC](https://community.replicated.com/t/i-want-to-create-an-airgap-installer-bundle/1612/5 "2026-04-24T00:30:55Z")

</div>

Hi @lepome,

Your spec has the kURL installer version pinned to `v2024.12.04-0`:

json

```auto
"kurl": {
  "excludeBuiltinHostPreflights": false,
  "installerVersion": "v2024.12.04-0"
}

```

This version is outdated and likely incompatible with other add-ons in your spec, which is causing the airgap bundle generation to fail.

**Fix:** Remove the `installerVersion` pin unless you have a specific reason to keep it. Here’s your spec without it: [https://kurl.sh/21975c8](https://kurl.sh/21975c8)

Let us know if that resolves it, and if you need further help with customer specifics, please open a support ticket at [Replicated](https://vendor.replicated.com/support).

Gerard

---

<div class="post-metadata">

**Author:** ![lepome](https://yyz2.discourse-cdn.com/flex030/user_avatar/community.replicated.com/lepome/32/780_2.png) [@lepome](https://community.replicated.com/u/lepome)\
**Post date:** [April 24, 2026, 1:05am UTC](https://community.replicated.com/t/i-want-to-create-an-airgap-installer-bundle/1612/6 "2026-04-24T01:05:02Z")

</div>

Here’s the deal: Some of our customers don’t update their applications as often as they should. As we discussed in [https://github.com/replicated-collab/knime-replicated/issues/396#issuecomment-3708404013](https://github.com/replicated-collab/knime-replicated/issues/396#issuecomment-3708404013) when those customers need to install an interim (required) version on their way to the current version, not pinning the installerVersion causes problems because they get the wrong supporting files (e.g. kurl-util). So I want to be sure that I am defining the correct collection of assets.

Asking AI gave me this command:  
`curl -fL -o kurlbundlefor1-13-3.tar.gz https://k8s.kurl.sh/bundle/2b60ce1.tar.gz `  
Will that work?

---

<div class="post-metadata">

**Author:** ![GerardNguyen](https://yyz2.discourse-cdn.com/flex030/user_avatar/community.replicated.com/gerardnguyen/32/828_2.png) [@GerardNguyen](https://community.replicated.com/u/GerardNguyen)\
**Post date:** [April 24, 2026, 5:23am UTC](https://community.replicated.com/t/i-want-to-create-an-airgap-installer-bundle/1612/7 "2026-04-24T05:23:51Z")

</div>

Hi @lepome

Thanks for the context,

I’m looking into this with our team for more details on airgap bundle generation for kURL `v2024.12.04-0`

In the meantime, could you open another vendor support ticket? Since this community forum is public, a support ticket will allow us to dig into your specific configuration in a more appropriate setting and get you a faster, more thorough response.

You can open a ticket at [Replicated](https://vendor.replicated.com/support).

Gerard

---

<div class="post-metadata">

**Author:** ![GerardNguyen](https://yyz2.discourse-cdn.com/flex030/user_avatar/community.replicated.com/gerardnguyen/32/828_2.png) [@GerardNguyen](https://community.replicated.com/u/GerardNguyen)\
**Post date:** [April 26, 2026, 6:45am UTC](https://community.replicated.com/t/i-want-to-create-an-airgap-installer-bundle/1612/8 "2026-04-26T06:45:49Z")

</div>

Hi @lepome,

The spec is fixed now. Could you try to download it again and let us know how it goes?

Gerard
