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.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 orLabelSelectors to the velero.io/v1 Backup resource for Full Snapshots.
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