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.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-configmapflag for thekots installcommand.
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-proxyflags for thekots installcommand 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-configmapflag to theinstallandgenerate-manifestscommands. The contents of the provided ConfigMap are used as additional trusted certificate authorities. - Adds the
PrivateCACerttemplate function to return the name of a ConfigMap containing additional trusted CA certificates provided by the end user.
Bug Fixes
- Fixes an issue where
dropdownConfig items did not respect thewhenproperty.
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.localaddress when making requests to thekotsadm-rqliteandkotsadm-minioservices 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
joincommand 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-proxyflags for thekots installcommand were not propagated to the Replicated SDK. - Hides a banner on the View Files page in Embedded Cluster that told users to use
kubectl kotscommands 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
nodeMetricsanalyzer 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
dropdownconfig item type, which creates a dropdown on the config screen. See dropdown in Config. - Adds the
radioconfig item type, which is functionally equivalent to theselect_oneitem type but is more clearly named. Theselect_oneconfig item type is deprecated in favor ofradiobut 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 installcommand 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-preflightsflag 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-forwardfor 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
k0sinstead ofembedded-clusterfor 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.