This is the multi-page printable view of this section. Click here to print.

Return to the regular view of this page.

Release Notes

Delve into our latest release notes, providing a comprehensive overview of the exciting updates and enhancements in our newest KOSI version.

1: KOSI Versions
2: KOSI 2.15.0_Beta0
3: KOSI 2.15.0_Alpha4
4: KOSI 2.15.0_Alpha3
5: KOSI 2.15.0_Alpha2
6: KOSI 2.15.0_Alpha1
7: KOSI 2.14.0_Beta1
8: KOSI 2.14.0_Beta0
9: KOSI 2.13.0
10: KOSI 2.12.1
11: KOSI 2.12.0
12: KOSI 2.12.0_Beta1
13: KOSI 2.12.0_Beta0
14: KOSI 2.12.0_Alpha1
15: KOSI 2.12.0_Alpha0

1 - KOSI Versions

KOSI versions and deprication dates

Here are the current supported KOSI Versions. The list contains: The KOSI version, Supported KOSI language version, Supported KOSI plugins and the Deprication date of all KOSI versions. X of the versions must be X of the plugins

KOSI	Supported KOSI language	Supported KOSI plugins	Deprecation date
KOSI 2.15.X	v1.0.0	Plugins 2.2.X	01.07.2027
KOSI 2.14.X	v1.0.0	Plugins 2.0.X	[not supported]
KOSI 2.13.X	v1.0.0	Plugins 2.0.X	13.04.2027
KOSI 2.12.X	v1.0.0	Plugins 1.7.X	01.10.2026
~~KOSI 2.11.X~~	~~v1.0.0~~	~~Plugins 1.6.X~~	~~01.11.2025~~
~~KOSI 2.10.X~~	~~v0.1.0~~	~~Plugins 1.5.X~~	~~12.03.2025~~

2 - KOSI 2.15.0_Beta0

KOSI 2.15.0_Beta0 - Release Date 30.07.2026

Changelog KOSI 2.15.0_Beta0

Whats new?

- SBOM command
    - Added the KOSI Tools sbom command

- config.yaml v3
    - Added a new version of the config.yaml
    - Checking for automatic updates of a newer KOSI version can now be turned on or off

- Misc
    - KOSI license confirmation during installation has been removed

Fixes

- Updated internal dependencies
- fixed a bug with license checks on plugins
- fixed a bug with checksums when pulling KOSI packages
- fixed a bug where registered users cannot pull packages, when hub has the permissions for registered users
- fixed a typo in kosi latest language log
- improved error messages for kosi manage commands
- kosi manage list users now works with the same groupname-structure as the other kosi manage commands
- fixed kosi manage add user and group
- add more detailed logging for pulling packages of already pulled packages

Changelog Plugins 2.2.0

Fixes

- Updated Plugins to Version 2.2.0_Beta0

3 - KOSI 2.15.0_Alpha4

Changelog KOSI 2.15.0_Alpha4 - Release Date 15.07.2026

New

SBOM command

Added the KOSI Tools sbom command

config.yaml v3

Added a new version of the config.yaml
Checking for automatic updates of a newer KOSI version can now be turned on or off

Misc

KOSI license confirmation during installation has been removed

Update

Updated internal dependencies

Bugfix

improved error messages for kosi manage commands
fixed kosi tools sbom command which gives no return if the package has no images (dev2821)
fixed kosi tools sbom command which gives no error if syft is not installed (dev2824)
fixed kosi tools sbom command which overwrites the main package, if command get executed.(dev2825)
fixed kosi manage add user and group (dev2874)
add more detailed logging for pulling packages of already pulled packages (dev2875)

4 - KOSI 2.15.0_Alpha3

Changelog KOSI 2.15.0_Alpha3 - Release Date 06.07.2026

New

SBOM command

Added the KOSI Tools sbom command

config.yaml v3

Added a new version of the config.yaml
Checking for automatic updates of a newer KOSI version can now be turned on or off

Misc

KOSI license confirmation during installation has been removed

Update

Updated internal dependencies

Bugfix

improved error messages for kosi manage commands
kosi manage list users now works with the same groupname-structure as the other kosi manage commands
improved kosi tools sbom log messages
fixed kosi tools sbom package pulling
fixed behavior of kosi tools sbom if syft is not installed or there are no images in the package

5 - KOSI 2.15.0_Alpha2

Changelog KOSI 2.15.0_Alpha2 - Release Date 15.06.2026

New

SBOM command

Added the KOSI Tools sbom command

config.yaml v3

Added a new version of the config.yaml
Checking for automatic updates of a newer KOSI version can now be turned on or off

Misc

KOSI license confirmation during installation has been removed

Update

Updated internal dependencies

Bugfix

Fixed a bug with license checks on plugins
Fixed a bug with checksums when pulling KOSI packages

6 - KOSI 2.15.0_Alpha1

Changelog KOSI 2.15.0_Alpha1 - Release Date 08.06.2026

New

SBOM Command

added kosi Tools sbom command

config.yaml v3

added a new Version for the config yaml. Checking for automatic updates of a newer Kosi Version can now be turned on or off.

Update

Update internal Dependencies
Update kosi create package.kosi

Bugfix

fixed a bug with License checks on Plugins
fixed a bug with checksums when pulling kosi packages
fixed a bug where registered users cannot pull packages, when hub has the permissions for registered users
fixed a typo in kosi latest language log

Changelog Plugins 2.2.0

Updated Plugins to Version 2.2.0_Alpha1

7 - KOSI 2.14.0_Beta1

Changelog KOSI 2.14.0_Beta1

Whats new?

- Permission management
    - added manage add user command
    - added manage add group command
    - added manage add-user-to-group command
    - added manage create group command
    - added manage list permissions command
    - added manage remove user command
    - added manage remove group command
    - added manage remove permission command
    - added manage user-from-group command

- Build
    - added optional parameter -o output-file on kosi build command
    - added optional parameter -r target-registry on kosi build command

Fixes

- Update internal Dependencies
- fixed a bug where the groupname always includes the hubname. Now it can leave it if the user is kubeops

Changelog Plugins 2.0.0

8 - KOSI 2.14.0_Beta0

KOSI 2.14.0_Beta0 - Release Date 02.03.2026

Changelog KOSI 2.14.0_Beta0

Whats new?

- Permission management
    - added manage add user command
    - added manage add group command
    - added manage add-user-to-group command
    - added manage create group command
    - added manage list permissions command
    - added manage remove user command
    - added manage remove group command
    - added manage remove permission command
    - added manage user-from-group command

Fixes

- Update internal Dependencies
- fixed a bug where the groupname always includes the hubname. Now it can leave it if the user is kubeops

Changelog Plugins 2.0.0

9 - KOSI 2.13.0

Changelog KOSI 2.13.0

Whats new?

- Create a config.yaml if there is no config.yaml

Fixes

- Update internal Dependencies
- fixed an issue where kosi crashes if there is no config
- fixed an issue where kosi could not installed on ubuntu
- fixed an Issue that local package installation calls dispatcher

Changelog Plugins 2.0.0

Fixes

- Update internal Dependencies

10 - KOSI 2.12.1

Changelog KOSI 2.12.1

Breaking Changes

⚠ Warning KOSI 2.12.0 does not support the old dispatcher url. it requires the new dispatcher: dispatcher.kubeops.net/v4/dispatcher.

Whats new?

- Now creates a default config.yaml, if there is no config.yaml.

Fixes

- Update Dependencies
- Update plugins
- fixed an issue with the config.yaml
- fixed an issue with the installation for ubuntu, where kubeopsroot was not used correctly.

Changelog Plugins 1.7.1

Fixes

- Update Dependencies

11 - KOSI 2.12.0

Changelog KOSI 2.12.0

Breaking Changes

⚠ Warning KOSI 2.12.0 does not support the old dispatcher url. it requires the new dispatcher: dispatcher.kubeops.net/v4/dispatcher.

Whats new?

- Added Licence verification
- Increase Upload-size for packages to 3Gb

Fixes

- Clientrequest timeouts set to 60 seconds
- Changed the image format on push to OCI
- Update Dependencies
- Update plugins
- KOSI lint linting package.yaml correctly
- fixed templating in lists
- fixed issue when pushing image to localregistry and not being authorized
- fixed an issue where kosi install with multiple value-files was not possible

Changelog Plugins 1.7.0

Whats new?

- set plugin: for setting variables

Fixes

- move some messages from info to debug in template-plugin and if-plugin
- change file destination from pia ssh-mode from /home/pia to /var/kubeops/pia  
- Update Dependencies
- fixed an issue that kosi plugin pull command requires retag buts optional
- fixed an issue that kosi plugin pull was not able to pull packages.
- fixed an issue that kubectl run operation was not executed correctly.

12 - KOSI 2.12.0_Beta1

Changelog KOSI 2.12.0.13_Beta1

Breaking Changes

⚠ Warning KOSI 2.12.0 does not support the old dispatcher url. it requires the new dispatcher: dispatcher.kubeops.net/v4/dispatcher.

Whats new?

- Added Licence verification
- Increase Upload-size for packages to 3Gb

Fixes

- Clientrequest timeouts set to 60 seconds
- Changed the image format on push to OCI
- Update Dependencies
- Update plugins
- KOSI lint linting package.yaml correctly
- fixed templating in lists
- fixed issue when pushing image to localregistry and not being authorized
- fixed an issue where kosi install with multiple value-files was not possible

Changelog Plugins 1.7.0

Whats new?

- set plugin: for setting variables

Fixes

- move some messages from info to debug in template-plugin and if-plugin
- change file destination from pia ssh-mode from /home/pia to /var/kubeops/pia  
- Update Dependencies
- fixed an issue that kosi plugin pull command requires retag buts optional
- fixed an issue that kosi plugin pull was not able to pull packages.
- fixed an issue that kubectl run operation was not executed correctly.
- fixed an issue that cmd plugin could not work if SHELL env was not set.

13 - KOSI 2.12.0_Beta0

Changelog KOSI 2.12.0_Beta0

Breaking Changes

⚠ Warning KOSI 2.12.0 does not support the old dispatcher url. it requires the new dispatcher: dispatcher.kubeops.net/v4/dispatcher.

Whats new?

- Added Licence verification
- Increase Upload-size for packages to 3Gb

Fixes

- Clientrequest timeouts set to 60 seconds
- Changed the image format on push to OCI
- Update Dependencies
- Update plugins
- KOSI lint linting package.yaml correctly
- fixed templating in lists
- fixed issue when pushing image to localregistry and not being authorized
- fixed an issue where kosi install with multiple value-files was not possible

Changelog Plugins 1.7.0

Whats new?

- set plugin: for setting variables

Fixes

- move some messages from info to debug in template-plugin and if-plugin
- change file destination from pia ssh-mode from /home/pia to /var/kubeops/pia  
- Update Dependencies

14 - KOSI 2.12.0_Alpha1

Changelog KOSI 2.12.0.12_Alpha1

New

Added Licence verification
Increase Upload-size for packages to 3Gb

Change

Clientrequest timeouts set to 60 seconds
Changed the image format on push to OCI

Update

Update Dependencies
Update plugins

Bugfix

KOSI lint linting package.yaml correctly
fixed templating in lists
fixed issue when pushing image to localregistry and not being authorized
fixed an issue where kosi install with multiple value-files was not possible

BREAKING CHANGE

KOSI 2.12.0 does not support the old dispatcher url. it requires the new dispatcher: dispatcher.kubeops.net/v4/dispatcher.

Changelog Plugins 1.7.0

New

set plugin: for setting variables

Change

move some messages from info to debug in template-plugin and if-plugin
change file destination from pia ssh-mode from /home/pia to /var/kubeops/pia

Update

Update Dependencies

15 - KOSI 2.12.0_Alpha0

Changelog KOSI 2.12.0_Alpha0

New

Added Licence verification
Increase Upload-size for packages to 3Gb

Change

Clientrequest timeouts set to 60 seconds
Changed the image format on push to OCI

Update

Update Dependencies
Update plugins

Bugfix

KOSI lint linting package.yaml correctly
fixed templating in lists
fixed issue when pushing image to localregistry and not being authorized

BREAKING CHANGE

KOSI 2.12.0 does not support the old dispatcher url. it requires the new dispatcher: dispatcher.kubeops.net/v4/dispatcher.

Changelog Plugins 1.7.0

New

set plugin: for setting variables

Change

move some messages from info to debug in template-plugin and if-plugin
change file destination from pia ssh-mode from /home/pia to /var/kubeops/pia

Update

Update Dependencies