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-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.