KOTS Release Notes
This topic contains release notes for the Replicated KOTS installer. The release notes list new features, improvements, bug fixes, known issues, and breaking changes.
Kubernetes Compatibility
The following table lists the versions of Kubernetes that are compatible with each version of KOTS:
KOTS Versions | Kubernetes Compatibility |
---|---|
1.117.0 and later | 1.31, 1.30, 1.29 |
1.109.1 to 1.116.1 | 1.30, 1.29, 1.28 |
1.105.2 to 1.109.0 | 1.29, 1.28 |
1.124.11
Released on April 2, 2025
Support for Kubernetes: 1.29, 1.30, and 1.31
Improvements
- Updates images to resolve several CVEs.
1.124.10
Released on March 27, 2025
Support for Kubernetes: 1.29, 1.30, and 1.31
Bug Fixes
- Fixes an issue where extracting Helm charts failed on deploy if duplicate files were found in the chart. This error often looked like this:
failed to deploy helm charts: failed to find removed charts: failed to find current matching v1beta2 charts: failed to find chart name and version in /tmp/helm2856031708/curr-v1beta2/helm/mychart: failed to unarchive: reading file in tar archive: file already exists: /tmp/kots1381434460/charts/mychart/Chart.yaml
.
1.124.9
Released on March 24, 2025
Support for Kubernetes: 1.29, 1.30, and 1.31
Improvements
- Updates to support custom domains for Embedded Cluster.
1.124.8
Released on March 20, 2025
Support for Kubernetes: 1.29, 1.30, and 1.31
Improvements
- Updates to support custom domains for Embedded Cluster.
1.124.7
Released on March 17, 2025
Support for Kubernetes: 1.29, 1.30, and 1.31
Improvements
- Updates to support custom domains for Embedded Cluster.
1.124.6
Released on March 13, 2025
Support for Kubernetes: 1.29, 1.30, and 1.31
Improvements
- Improvements for Embedded Cluster upgrades.
1.124.5
Released on March 11, 2025
Support for Kubernetes: 1.29, 1.30, and 1.31
Bug Fixes
- Fixes SBOM generation and signing issue. A properly signed SBOM is now included in the release artifacts.
1.124.4
Released on February 14, 2025
Support for Kubernetes: 1.29, 1.30, and 1.31
Improvements
- Improves error visibility by displaying the actual error message in the UI instead of a generic one when an upgrade fails to start.
Bug Fixes
- Fixes an issue when installing with a provided license, that can cause the installer not to respect the custom domain in the license and instead make a request to https://replicated.app.
1.124.3
Released on February 5, 2025
Support for Kubernetes: 1.29, 1.30, and 1.31
Improvements
- Updates images to resolve CVE-2024-45337 with critical severity and CVE-2024-45338 with high severity.
1.124.2
Released on February 4, 2025
Support for Kubernetes: 1.29, 1.30, and 1.31
Improvements
- Improvements for Embedded Cluster upgrades.
1.124.1
Released on January 29, 2025
Support for Kubernetes: 1.29, 1.30, and 1.31
Bug Fixes
- Improves an unclear error message that could occur when rewriting private images.
1.124.0
Released on January 24, 2025
Support for Kubernetes: 1.29, 1.30, and 1.31
New Features
-
You can migrate Helm charts that were installed with HelmChart
v1beta1
anduseHelmInstall: false
to HelmChartv1beta2
by passing the--take-ownership
flag to thehelmUpgradeFlags
field in HelmChart custom resource as shown below:# HelmChart v1 beta2
apiVersion: kots.io/v1beta2
kind: HelmChart
metadata:
name: samplechart
spec:
helmUpgradeFlags:
- --take-ownershipThis flag allows Helm to take ownership of existing resources that were installed without Helm, like resources deployed with HelmChart v1beta1 and
useHelmInstall: false
.For information about how to migrate an existing installation to KOTS HelmChart
v1beta2
, see Migrating Existing Installations to HelmChart v2.
1.123.1
Released on January 13, 2025
Support for Kubernetes: 1.29, 1.30, and 1.31
Bug Fixes
- Fixes an issue where the navigation menu was not visible on the Config page.
1.123.0
Released on January 2, 2025
Support for Kubernetes: 1.29, 1.30, and 1.31
New Features
- Adds the
--tolerations
flag tokots install
to supply additional tolerations to the KOTS pods.
1.122.1
Released on December 20, 2024
Support for Kubernetes: 1.29, 1.30, and 1.31
Bug Fixes
- Fixes a bug that could result in instance being reported as unavailable if application includes an Ingress resource.
1.122.0
Released on December 12, 2024
Support for Kubernetes: 1.29, 1.30, and 1.31
New Features
- Adds support for the
kots.io/keep
annotation, which prevents KOTS from deleting resources during an upgrade if the resource is no longer present in the new release. This annotation is useful when migrating existing KOTS installations to the KOTS HelmChart v2 installation method. For more information, see Migrating Existing Installations to HelmChart v2.
1.121.2
Released on November 27, 2024
Support for Kubernetes: 1.29, 1.30, and 1.31
Improvements
- Various updates for Embedded Cluster.
1.121.1
Released on November 26, 2024
Support for Kubernetes: 1.29, 1.30, and 1.31
Bug Fixes
- Various fixes for Embedded Cluster.
1.121.0
Released on November 12, 2024
Support for Kubernetes: 1.29, 1.30, and 1.31
New Features
- Adds the ability to download the application archive for any version, including the currently deployed version, by using the
--sequence
and--current
flags for thekots download
command.
1.120.3
Released on November 7, 2024
Support for Kubernetes: 1.29, 1.30, and 1.31
Improvements
- Various updates for Embedded Cluster.
1.120.2
Released on November 5, 2024
Support for Kubernetes: 1.29, 1.30, and 1.31
Bug Fixes
- Fixes an issue where generating a support bundle in air gap kURL environments took a really long time.
1.120.1
Released on November 4, 2024
Support for Kubernetes: 1.29, 1.30, and 1.31
Bug Fixes
- Fixes an issue where generating support bundles failed in air gap and minimal RBAC installations.
- Fixes an issue where pushing images from an air gap bundle could time out due to the host's environment variables interfering with the temporary registry used by the KOTS CLI.
1.120.0
Released on October 30, 2024
Support for Kubernetes: 1.29, 1.30, and 1.31
New Features
- Various new features to support Replicated Embedded Cluster.
1.119.1
Released on October 22, 2024
Support for Kubernetes: 1.29, 1.30, and 1.31
Bug Fixes
- Fixes an issue where proxy settings was removed when upgrading the Admin Console with
kubectl kots admin-console upgrade
. - Fixes an issue where
--strict-security-context
was removed when upgrading the Admin Console withkubectl kots admin-console upgrade
.
1.119.0
Released on October 18, 2024
Support for Kubernetes: 1.29, 1.30, and 1.31
Bug Fixes
- Fixes an issue where the Replicated SDK failed to deploy if a private CA was provided to the installation but the SDK was installed into a different namespace than KOTS.
- If an application includes the Replicated SDK, the SDK will be deployed with the same ClusterRole as the Admin Console.
1.118.0
Released on October 15, 2024
Support for Kubernetes: 1.29, 1.30, and 1.31
Improvements
- Improves the flexibility of configuring the Cluster Resources collector in support bundle specs by limiting KOTS's default collection to its own namespace.
Bug Fixes
- Fixes an issue where you could not upgrade Embedded Cluster instances if the new version didn't include config and preflight checks.
1.117.5
Released on October 8, 2024
Support for Kubernetes: 1.29, 1.30, and 1.31
Improvements
- Adds support for specifying an alternative data directory in Embedded Cluster.
1.117.4
Released on October 8, 2024
Support for Kubernetes: 1.29, 1.30, and 1.31
Improvements
- Various improvements for surfacing errors in Embedded Cluster upgrades.
1.117.3
Released on September 23, 2024
Support for Kubernetes: 1.29, 1.30, and 1.31
New Features
- If the Replicated SDK is deployed by KOTS as part of an application, the SDK will automatically be configured with any additional CA certificates provided to
--private-ca-configmap
flag for thekots install
command.
1.117.2
Released on September 20, 2024
Support for Kubernetes: 1.29, 1.30, and 1.31
Improvements
- Improvements to support specifying ports in Embedded Cluster.
1.117.1
Released on September 17, 2024
Support for Kubernetes: 1.29, 1.30, and 1.31
Bug Fixes
- Fixes an issue where the values provided to the
--http-proxy
,--https-proxy
, and--no-proxy
flags for thekots install
command were not propagated to the Replicated SDK when running an automated install.
1.117.0
Released on September 13, 2024
Support for Kubernetes: 1.29, 1.30, and 1.31
New Features
- Adds the
--private-ca-configmap
flag to theinstall
andgenerate-manifests
commands. The contents of the provided ConfigMap are used as additional trusted certificate authorities. - Adds the
PrivateCACert
template function to return the name of a ConfigMap containing additional trusted CA certificates provided by the end user.
Bug Fixes
- Fixes an issue where
dropdown
Config items did not respect thewhen
property.
1.116.1
Released on September 12, 2024
Support for Kubernetes: 1.28, 1.29, and 1.30
Bug Fixes
- KOTS now uses the fully qualified
.svc.cluster.local
address when making requests to thekotsadm-rqlite
andkotsadm-minio
services for simplified HTTP proxy configuration usingNO_PROXY=.cluster.local
.
1.116.0
Released on September 9, 2024
Support for Kubernetes: 1.28, 1.29, and 1.30
New Features
- Adds the ability to specify additional annotations (
--additional-annotations
) and labels (--additional-labels
) that will be applied to kotsadm pods.
1.115.2
Released on September 5, 2024
Support for Kubernetes: 1.28, 1.29, and 1.30
Improvements
- Available updates and the check for updates button are shown on the Dashboard page of the Admin Console for Embedded Cluster. These were removed in a previous version.
- When nodes need to be added to the cluster during an Embedded Cluster restore operation, the
join
command is more clearly shown in the Admin Console. - Improves messaging when the requested channel slug is not allowed by the provided license.
Bug Fixes
- Fixes an issue where the values provided to the
--http-proxy
,--https-proxy
, and--no-proxy
flags for thekots install
command were not propagated to the Replicated SDK. - Hides a banner on the View Files page in Embedded Cluster that told users to use
kubectl kots
commands that are not intended for Embedded Cluster.
1.115.1
Released on August 22, 2024
Support for Kubernetes: 1.28, 1.29, and 1.30
Bug Fixes
- Fixes an issue where the default
nodeMetrics
analyzer did not run.
1.115.0
Released on August 20, 2024
Support for Kubernetes: 1.28, 1.29, and 1.30
Improvements
- The Nodes page displays guidance and easier access to the node join command during initial install of Embedded Cluster.
- Adds back the check for updates button on the Version history page in Embedded Cluster, so you can check for updates without refreshing the page.
1.114.0
Released on August 12, 2024
Support for Kubernetes: 1.28, 1.29, and 1.30
New Features
- Adds support for the
dropdown
config item type, which creates a dropdown on the config screen. See dropdown in Config. - Adds the
radio
config item type, which is functionally equivalent to theselect_one
item type but is more clearly named. Theselect_one
config item type is deprecated in favor ofradio
but is still fully functional. See radio in Config.
1.113.0
In KOTS 1.113.0 and later, an installation error can occur if you use the kots install
command without specifying a channel slug and the license used to install does not have access to the Stable channel. For more information, see Breaking Change below.
Released on August 9, 2024
Support for Kubernetes: 1.28, 1.29, and 1.30
New Features
-
Adds support for multi-channel licenses. This allows each license to be assigned to more than one channel.
With the introduction of multi-channel licenses, an installation error can occur if you use the
kots install
command without specifying a channel slug and the license used to install does not have access to the Stable channel. For more information, see Breaking Change below.
Bug Fixes
- Fixes an issue in Embedded Cluster where going back to the Nodes page during the installation and then clicking continue did not work.
Breaking Change
In KOTS 1.113.0 and later, the following error will occur during installation if the kots install
command lacks a channel slug and the license does not have access to the Stable channel: "failed to verify and update license: requested channel not found in latest license"
. This can break existing automation and documentation that includes a kots install
command without a channel slug.
This error occurs because, when the channel slug is omitted from the kots install
command (for example, kots install app
), KOTS defaults to pulling metadata like the application icon and minimal RBAC configurations from the Stable channel. With the introduction of multi-channel licenses in KOTS 1.113.0, only licenses with access to a channel can pull metadata and download releases from that channel. This means that only licenses with access to the Stable channel can install without specifying the channel slug in the kots install
command.
Previously, any license regardless of its assigned channel could install by excluding the channel slug from the kots install
command. This could cause mismatches in deployment settings such as icons and minimal RBAC configurations because KOTS would pull metadata from the Stable channel and then install the release from the channel where the license was assigned.
Solution: To install a release from a channel other than Stable, specify the channel slug in the kots install
command (for example, kots install app/beta
). Also, ensure that the license has access to the specified channel. Refer to the Vendor Portal installation instructions or use the replicated channel inspect CHANNEL_ID
command in the Replicated CLI for the correct commands.
To avoid breaking changes, update automation that uses the kots install
command accordingly. Also, update documentation as needed so that the documented installation commands include the channel slug.
If you cannot update your KOTS installation command immediately, temporarily revert to KOTS 1.112.4 or earlier.
1.112.4
Released on July 31, 2024
Support for Kubernetes: 1.27, 1.28, 1.29, and 1.30
Bug Fixes
- Fixes an issue in Embedded Cluster upgrades where preflights did not rerun when the config was re-edited.
- Fixes an issue that caused K8s minor version parsing errors to be logged repeatedly.
1.112.3
Released on July 30, 2024
Support for Kubernetes: 1.27, 1.28, 1.29, and 1.30
Bug Fixes
- Fixes an issue where the Admin Console vVersion history page for Embedded Cluster had to be refreshed to show a newly available version after uploading an air gap bundle.
1.112.2
Released on July 26, 2024
Support for Kubernetes: 1.27, 1.28, 1.29, and 1.30
Bug Fixes
- Fixes an issue in Embedded Cluster upgrades where rendering Helm charts that utilize Helm capabilities could fail.
1.112.1
Released on July 16, 2024
Support for Kubernetes: 1.27, 1.28, 1.29, and 1.30
Bug Fixes
- Fixes an issue where reporting information wasn't sent for Embedded Cluster in some cases.
1.112.0
Released on June 27, 2024
Support for Kubernetes: 1.27, 1.28, 1.29, and 1.30
New Features
- Changes the workflow for upgrading to newly available versions in the Admin Console for Embedded Cluster only. When upgrading to new versions, users are taken through a wizard where the license is sycned, config can be edited, and preflight checks are run before deploying.
1.111.0
Released on July 9, 2024
Support for Kubernetes: 1.27, 1.28, 1.29, and 1.30
Bug Fixes
- Fixes an issue where the Troubleshoot button on the Resource status modal didn't take you to the Troubleshoot page.
1.110.0
Released on June 27, 2024
Support for Kubernetes: 1.27, 1.28, 1.29, and 1.30
New Features
- Adds the ability to specify a custom storage class for the KOTS Admin Console components when installing to an existing cluster.
1.109.14
Released on June 21, 2024
Support for Kubernetes: 1.27, 1.28, 1.29, and 1.30
Bug Fixes
- Fixes an issue where required releases were enforced in air gapped mode when changing between channels that didn't have semantic versioning enabled
1.109.13
Released on June 20, 2024
Support for Kubernetes: 1.27, 1.28, 1.29, and 1.30
Improvements
- Changes to support Embedded Cluster.
1.109.12
Released on June 10, 2024
Support for Kubernetes: 1.27, 1.28, 1.29, and 1.30
Improvements
- Updates to enable high availability support for embedded cluster.
Bug Fixes
- Fixes an issue where air gap uploads could incorrectly fail with an error indicating the version being uploaded matches the current version. This occurred because the version labels matched and were valid semantic versions. Comparing version labels is intentional for channels with semantic versioning enabled, but was unintentional for channels without semantic versioning enabled.
1.109.11
Released on June 7, 2024
Support for Kubernetes: 1.27, 1.28, 1.29, and 1.30
Improvements
- Minor UI improvements for the air gap bundle upload progress bar.
Bug Fixes
- Fixes an issue where the
--skip-preflights
flag would not work if all strict preflights passed but a non-strict preflight failed.
1.109.10
Released on June 6, 2024
Support for Kubernetes: 1.27, 1.28, 1.29, and 1.30
Improvements
- Various updates to enable high availability support for embedded cluster.
1.109.9
Released on May 31, 2024
Support for Kubernetes: 1.27, 1.28, 1.29, and 1.30
Improvements
- Various updates to enable high availability support for embedded cluster.
Bug Fixes
- An incorrect CLI command for generating support bundles is no longer shown on the Troubleshoot page in embedded clusters.
1.109.8
Released on May 30, 2024
Support for Kubernetes: 1.27, 1.28, 1.29, and 1.30
Improvements
- Updates to enable high-availability support for Embedded Cluster.
1.109.7
Released on May 29, 2024
Support for Kubernetes: 1.27, 1.28, 1.29, and 1.30
Improvements
- Updates to enable high-availability support for embedded cluster.
1.109.6
Released on May 24, 2024
Support for Kubernetes: 1.27, 1.28, 1.29, and 1.30
Improvements
- Updates to enable disaster recovery support for embedded cluster.
1.109.5
Released on May 23, 2024
Support for Kubernetes: 1.27, 1.28, 1.29, and 1.30
Improvements
- Updates to enable disaster recovery support for embedded cluster.
1.109.4
Released on May 21, 2024
Support for Kubernetes: 1.27, 1.28, 1.29, and 1.30
Bug Fixes
- Fix
kubectl kots port-forward
for high-latency network connections.