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.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.
1.109.3
Released on May 15, 2024
Support for Kubernetes: 1.27, 1.28, 1.29, and 1.30
Bug Fixes
- Fixes an issue where the Distribution template function returned
k0s
instead ofembedded-cluster
for embedded clusters.
1.109.2
Released on May 15, 2024
Support for Kubernetes: 1.27, 1.28, 1.29, and 1.30
Improvements
- Updates images to resolve CVE-2024-33599 with high severity; and CVE-2024-33600, CVE-2024-33601, CVE-2024-33602 with medium severity.
1.109.1
Released on May 15, 2024
Support for Kubernetes: 1.27, 1.28, 1.29, and 1.30
Improvements
- Displays the volume name, Pod name, and namespace of snapshotted volumes in the snapshot details page.
Bug Fixes
- Fixes an issue where the Config and View files tabs did not display as active when clicked.
- Fixes an issue where KOTS failed to process Helm charts with required values that were configured with the v1beta2 HelmChart custom resource.
1.109.0
Released on May 9, 2024
Support for Kubernetes: 1.27, 1.28, and 1.29
New Features
- Adds the ability to detect embedded cluster with the Distribution template function.
1.108.13
Released on May 6, 2024
Support for Kubernetes: 1.26, 1.27, 1.28, and 1.29
Improvements
- Updates the snapshot settings page to clarify that the retention policy applies to all snapshots, not just scheduled snapshots.
1.108.12
Released on May 3, 2024
Support for Kubernetes: 1.27, 1.28, and 1.29
Bug Fixes
- Fixes an issue where the snapshot settings card on the admin console dashboard contained an extra slash in the object store bucket path.
1.108.11
Released on May 1, 2024
Support for Kubernetes: 1.27, 1.28, and 1.29
Improvements
- Various updates to enable disaster recovery support for embedded cluster.
- Updates Troubleshoot to v0.91.0.
1.108.10
Released on April 26, 2024
Support for Kubernetes: 1.27, 1.28, and 1.29
Improvements
- Various updates to enable disaster recovery support for embedded cluster.
1.108.9
Released on April 24, 2024
Support for Kubernetes: 1.26, 1.27, 1.28, and 1.29
Improvements
- Updates images to resolve CVE-2024-3817 with critical severity.
Bug Fixes
- Fixes an issue where the Edit config link on the dashboard didn't work.
1.108.8
Released on April 18, 2024
Support for Kubernetes: 1.26, 1.27, 1.28, and 1.29
Improvements
- Various updates to improve air gap and multi-node support for embedded cluster.
1.108.7
Released on April 16, 2024
Support for Kubernetes: 1.26, 1.27, 1.28, and 1.29
Improvements
- Various updates to enable air gap and multi-node support for embedded cluster.
1.108.6
Released on April 11, 2024
Support for Kubernetes: 1.26, 1.27, 1.28, and 1.29
Improvements
- Provide a progress indicator to users when pushing images and embedded cluster artifacts during an installation.
1.108.5
Released on April 8, 2024
Support for Kubernetes: 1.26, 1.27, 1.28, and 1.29
Improvements
- Various updates to enable air gap support for embedded cluster.
1.108.4
Released on April 3, 2024
Support for Kubernetes: 1.26, 1.27, 1.28, and 1.29
Improvements
- Re-builds the kotsadm image with the latest Wolfi base image to mitigate CVE-2024-3094.
1.108.3
Released on March 26, 2024
Support for Kubernetes: 1.26, 1.27, 1.28, and 1.29
Improvements
- Updates to enable air gap support for embedded cluster.
1.108.2
Released on March 25, 2024
Support for Kubernetes: 1.26, 1.27, 1.28, and 1.29
Improvements
- Various updates to enable air gap support for embedded cluster.
1.108.1
Released on March 19, 2024
Support for Kubernetes: 1.26, 1.27, 1.28, and 1.29
Improvements
- Prevents application rollback in Embedded Cluster installations.
Bug Fixes
- Fixes an issue in Embedded Cluster where forward slashes were replaced with dashes in custom role labels.
1.108.0
Released on March 5, 2024
Support for Kubernetes: 1.26, 1.27, 1.28, and 1.29
New Features
- Adds the ability to get the config values of the currently deployed app version via the CLI by passing the
--current
flag to the kubectl kots get config CLI command. - Adds the ability to update the config values of the currently deployed app version via the CLI by passing the
--current
flag to the kubectl kots set config CLI command. - Adds the ability to update the config values of any app version via the CLI by providing the target sequence with the
--sequence
flag in the kubectl kots set config CLI command. - Adds the ability to update the config values for any app version using the admin console.
Improvements
- Hides the Application and Cluster Management tabs on the admin console navbar during the initial installation flow with Replicated embedded cluster (Beta). For more information, see Using Embedded Cluster.
Bug Fixes
- Fixes an issue where the license upload page flashed briefly before being redirected to the login page.
- Fixes an issue in embedded cluster (Beta) where the cluster upgrade modal occasionally failed to display during upgrades.
1.107.8
Released on February 27, 2024
Support for Kubernetes: 1.26, 1.27, 1.28, and 1.29
Improvements
- Resolves the false positive CVEs with critical severity in the
kotsadm
image which stemmed from the Dex Go library.
1.107.7
Released on February 23, 2024
Support for Kubernetes: 1.26, 1.27, 1.28, and 1.29
Bug Fixes
- Fixes an issue where the "Ignore Preflights" button was not displayed on the preflights page when preflights were running.
- Fixes an issue where the LicenseFieldValue template function did not return the new value when syncing the license.
1.107.6
Released on February 22, 2024
Support for Kubernetes: 1.26, 1.27, 1.28, and 1.29
Improvements
- UI improvements when running in an embedded cluster (Alpha)
1.107.5
Released on February 20, 2024
Support for Kubernetes: 1.26, 1.27, 1.28, and 1.29
Bug Fixes
- Fixes an issue in kURL clusters where images from Helm charts configured using the v1beta2 HelmChart custom resource were incorrectly removed from the in-cluster registry, potentially leading to failed deployments.
1.107.4
Released on February 16, 2024
Support for Kubernetes: 1.26, 1.27, 1.28, and 1.29
Bug Fixes
- Fixes an issue where processing images from Helm charts configured using the v1beta2 HelmChart custom resource may fail in air gapped mode.
1.107.3
Released on February 12, 2024
Support for Kubernetes: 1.26, 1.27, 1.28, and 1.29
Bug Fixes
- Fixes an issue where the preflights page was not displayed during initial installation if the preflight spec was included in a Secret or ConfigMap in the Helm chart templates.
1.107.2
Released on February 2, 2024
Support for Kubernetes: 1.26, 1.27, 1.28, and 1.29
Improvements
- Removes the rqlite DB data dump from support bundles generated by KOTS.
- Updates the
minio
,rqlite
,dex
, andlocal-volume-provider
images to resolves CVE-2023-6779, CVE-2023-6246, CVE-2024-21626 with high severity; and CVE-2023-6780 with medium severity.
1.107.1
Released on February 1, 2024
Support for Kubernetes: 1.26, 1.27, 1.28, and 1.29
Improvements
- Updates the
kotsadm
,kotsadm-migrations
, andkurl-proxy
images to resolves CVE-2023-6779, CVE-2023-6246, CVE-2024-21626 with high severity; and CVE-2023-6780 with medium severity.
1.107.0
Released on January 30, 2024
Support for Kubernetes: 1.26, 1.27, 1.28, and 1.29
New Features
- Adds support for running KOTS on ARM64 nodes. For air gap installations, the KOTS air gap bundle has an updated format and also now includes images for both AMD64 and ARM64 architectures. When updating KOTS in air gap environments, ensure the CLI version you use matches the version of the KOTS air gap bundle because earlier KOTS versions are not compatible with the new air gap bundle format. For more information about KOTS installation requirements, see Installation Requirements.
Improvements
- Removes support
kubectlVersion
andkustomizeVersion
in the KOTS Application custom resource. One version of kubectl and one version of kustomize are now included in KOTS and will always be used.
1.106.0
Released on January 23, 2024
Support for Kubernetes: 1.26, 1.27, 1.28, and 1.29
New Features
- Adds support for an experimental air gap bundle feature that allows KOTS to process partial air gap bundles that only include the images needed to update to the desired version.
1.105.5
Released on January 18, 2024
Support for Kubernetes: 1.26, 1.27, 1.28, and 1.29
Improvements
- Adds the namespace to the password reset command that is displayed when the admin console is locked after hitting the limit of unsuccessful login attempts.
1.105.4
Released on January 16, 2024
Support for Kubernetes: 1.26, 1.27, 1.28, and 1.29
Bug Fixes
- Fixes an issue where Pods associated with KOTS components could be incorrectly scheduled on a non-AMD64 node.
- Fixes an issue where configuring snapshots to use internal storage failed in kURL clusters with HA MinIO and OpenEBS.