-
3.0.0-rc9 / Fixes dependency problems
StableAll checks were successfulBuild release binaries and packages / build-packages (amd64, windows) (push) Successful in 2m0sBuild release binaries and packages / build-packages (amd64, darwin) (push) Successful in 2m30sBuild release binaries and packages / build-packages (arm64, freebsd) (push) Successful in 3m1sBuild and push OCI image / build (push) Successful in 2m15sBuild release binaries and packages / build-packages (amd64, freebsd) (push) Successful in 4m55sBuild release binaries and packages / build-packages (amd64, linux) (push) Successful in 5m2sBuild release binaries and packages / build-packages (arm64, linux) (push) Successful in 2m48smetal3d released this
2025-09-23 10:35:23 +00:00 | 0 commits to master since this releaseWhat's new?
This release addresses several key issues to improve stability and usability. Notably, it includes fixes related to dependency management, ensuring that depends-on relationships are correctly handled and optimized for faster deployment. Additionally, improvements have been made to error messaging, providing clearer guidance when commands fail, especially in scenarios where Katenary encounters issues.
Overall, this release emphasizes stability and clarity, with targeted fixes that resolve previous issues and improve the robustness of the system.
Install
- Use the package page to configure your distribution repository (deb, rpm, arch...).
- macOS and Windows users can get the setup.exe file in "Generic" packages (brew package in progress).
Notable changes
- @metal3d in commit
614a1df5ba: Fixes how depends-on relationships are managed, including renaming and static file handling, leading to faster deployment pro
cesses. (Addresses #174 and #173) - @metal3d in commit
f0436ebce1: Improves error messaging when Katenary fails, providing clearer guidance instead of generic command errors.
Downloads
-
3.0.0-rc8 / The next possible version
StableAll checks were successfulGo-Tests / tests (push) Successful in 2m45sGo-Tests / sonar (push) Successful in 1m2sBuild release binaries and packages / build-packages (amd64, darwin) (push) Successful in 1m34sBuild release binaries and packages / build-packages (amd64, freebsd) (push) Successful in 2m47sBuild release binaries and packages / build-packages (amd64, windows) (push) Successful in 2m53sBuild release binaries and packages / build-packages (amd64, linux) (push) Successful in 3m18sBuild release binaries and packages / build-packages (arm64, freebsd) (push) Successful in 2m42sBuild release binaries and packages / build-packages (arm64, linux) (push) Successful in 1m44sBuild and push OCI image / build (push) Successful in 1m54s2025-09-23 07:02:59 +00:00 | 3 commits to master since this releaseWhat's new?
This release addresses several important fixes and improvements across the project. Notably, it resolves issues related to volume mounting, ensuring that files from the project root are correctly handled, which enhances reliability in various deployment scenarios. The versioning system has been refined to better support release tags, preventing build inconsistencies and streamlining the release process. Additionally, the repository references and documentation have been updated to reflect the new project location, improving clarity and accessibility for users and contributors.
The update also includes enhancements to the build and packaging workflows, making them more robust and easier to maintain. These changes contribute to a more stable and predictable development environment, reducing potential errors during CI/CD processes. Overall, this release emphasizes stability and clarity, with fixes that improve the core functionality and user experience.
Furthermore, the project now leverages newer dependencies and tools, such as Go 1.25, to ensure compatibility and security. The modifications also include better logging and output management, which facilitate troubleshooting and monitoring. These improvements collectively support ongoing development and deployment efforts, making the project more reliable and easier to work with.
Installation
You can now use packages for major distributions (Fedora, Alma, Rocky, Red Hat, Debian, Ubuntu, Arch...) - follow steps in https://repo.katenary.io/Katenary/katenary/packages
You can also use Docker or Podman, see https://repo.katenary.io/Katenary/-/packages/container/katenary/latest (mount your project in
/appand use correctUID, documentation is comming soon)Windows users can use https://repo.katenary.io/Katenary/-/packages/generic/katenary/3.0.0-rc8/files/281 (setup installer)
Notable changes
- @metal3d #03b4d5c: Fix volume mounting for files from project root, ensuring correct volume name generation.
- @metal3d #debe43c: Improve version prefix handling to prevent build issues with versioning.
- @metal3d #ef1ff27: Update repository references and documentation to reflect the new project URL.
- @metal3d #f539be8: Transition to Go 1.25, enhancing build stability and security.
- @metal3d #9479212: Refine CI/CD workflows for better build and package management.
- @metal3d #6cd1c92: Enhance documentation with clearer instructions and package information.
- @metal3d #8e54d61: Remove obsolete references and streamline project branding.
Downloads
-
v3.0.0-rc6 Stable
2025-08-13 08:26:13 +00:00 | 38 commits to master since this releaseWhat's Changed
- fix(katenaryfile): Fix parsing katenary file by @metal3d in https://github.com/Katenary/katenary/pull/145
- fix(katenaryfile): Schema is broken without json annotation by @metal3d in https://github.com/Katenary/katenary/pull/146
- fix(configmap): File from the root of project ends by a dash by @metal3d in https://github.com/Katenary/katenary/pull/154
- Develop by @metal3d in https://github.com/Katenary/katenary/pull/155
- feat(refacto): move everything in internal package by @metal3d in https://github.com/Katenary/katenary/pull/156
- Features/oci image by @metal3d in https://github.com/Katenary/katenary/pull/157
- feat(oci): Use Buildah by @metal3d in https://github.com/Katenary/katenary/pull/158
- Features/buildah build by @metal3d in https://github.com/Katenary/katenary/pull/159
Full Changelog: https://github.com/Katenary/katenary/compare/3.0.0-rc5...3.0.0-rc6
Common packages and setup
- Podman / Docker :
podman pull ghcr.io/katenary/katenary:3.0.0-rc6ordocker pull ghcr.io/katenary/katenary:3.0.0-rc6 - Mac / Linux Brew:
brew install katenary/tap/katenary - Windows: https://github.com/Katenary/katenary/releases/download/3.0.0-rc6/katenary-windows-setup.exe
- Fedora / Rocky / Alma / Red Hat: https://github.com/Katenary/katenary/releases/download/3.0.0-rc6/katenary-3.0.0_rc6-1.x86_64.rpm
- Debian / Ubuntu: https://github.com/Katenary/katenary/releases/download/3.0.0-rc6/katenary_3.0.0-rc6_amd64.deb
Also: - Linux binary file : https://github.com/Katenary/katenary/releases/download/3.0.0-rc6/katenary-linux-amd64 (to be placed in your
$PATHlike~/.local/binor/usr/local/bin)
Others packages and architectures, tarball, Freebsd packages, Arch Linux package... Please expand the assets list below.
You may also use tarball, change architectures
Downloads
-
v3.0.0-rc5 Stable
2025-07-15 11:59:22 +00:00 | 62 commits to master since this releaseWhat's Changed
- Develop by @metal3d in https://github.com/Katenary/katenary/pull/131
- fix(deployment): Missed the command from compose file by @metal3d in https://github.com/Katenary/katenary/pull/135
- Develop by @metal3d in https://github.com/Katenary/katenary/pull/134
- Develop by @metal3d in https://github.com/Katenary/katenary/pull/137
- Develop by @metal3d in https://github.com/Katenary/katenary/pull/138
- fix(doc): Fix documentation linkg by @metal3d in https://github.com/Katenary/katenary/pull/139
- Develop by @metal3d in https://github.com/Katenary/katenary/pull/140
- Develop by @metal3d in https://github.com/Katenary/katenary/pull/141
- chore(make): manpage requirements are now in requirements by @metal3d in https://github.com/Katenary/katenary/pull/142
There is now packages:
- rpm
- debian
- arch (zst package)
- windows setup (find katenary-windows-setup.exe in the list below)
- freebsd
- tar for all unix version excpted osx
Full Changelog: https://github.com/Katenary/katenary/compare/3.0.0-rc4...3.0.0-rc5
Downloads
-
v3.0.0-rc4 Stable
2025-07-07 11:51:13 +00:00 | 109 commits to master since this releaseRecompile to fix Windows binary.
See https://github.com/upx/upx/issues/437 and #130 to understand the problems.
What's Changed
- feat(doc): regenerate the package docs by @metal3d in https://github.com/metal3d/katenary/pull/127
- Feat change actions by @metal3d in https://github.com/metal3d/katenary/pull/128
- Many fixes on code quality and CI by @metal3d in https://github.com/metal3d/katenary/pull/129
- fix(build): Windows is a shame by @metal3d in https://github.com/metal3d/katenary/pull/130
Full Changelog: https://github.com/metal3d/katenary/compare/3.0.0-rc3...3.0.0-rc4
Downloads
-
v3.0.0-rc3 Stable
2025-07-04 13:08:40 +00:00 | 135 commits to master since this releaseWhat's Changed
- chore(presentation): Update README by @metal3d in https://github.com/metal3d/katenary/pull/94
- Add SecretName in TLS + adapt github actions by @metal3d in https://github.com/metal3d/katenary/pull/95
- Fixing docs by @metal3d in https://github.com/metal3d/katenary/pull/96
- Enhance tests by @metal3d in https://github.com/metal3d/katenary/pull/101
- chore(deps): bump k8s.io/apimachinery from 0.32.0 to 0.32.1 by @dependabot in https://github.com/metal3d/katenary/pull/105
- chore(deps): bump github.com/invopop/jsonschema from 0.12.0 to 0.13.0 by @dependabot in https://github.com/metal3d/katenary/pull/103
- chore(deps): bump k8s.io/api from 0.32.0 to 0.32.1 by @dependabot in https://github.com/metal3d/katenary/pull/104
- Develop by @metal3d in https://github.com/metal3d/katenary/pull/108
- Fix example of docker-compose.yml by @GSergeevich in https://github.com/metal3d/katenary/pull/114
- Develop by @metal3d in https://github.com/metal3d/katenary/pull/117
- Develop by @metal3d in https://github.com/metal3d/katenary/pull/118
- Develop by @metal3d in https://github.com/metal3d/katenary/pull/119
- Develop by @metal3d in https://github.com/metal3d/katenary/pull/120
- Merge branch 'master' into develop by @metal3d in https://github.com/metal3d/katenary/pull/126
New Contributors
- @GSergeevich made their first contribution in https://github.com/metal3d/katenary/pull/114
Full Changelog: https://github.com/metal3d/katenary/compare/3.0.0-rc2...3.0.0-rc3
Downloads
-
v3.0.0-rc2 Stable
2024-12-03 13:53:34 +00:00 | 185 commits to master since this releaseWhat's Changed
- Merge Develop to prepare V3 by @metal3d in https://github.com/metal3d/katenary/pull/77
- Develop by @metal3d in https://github.com/metal3d/katenary/pull/78
- Develop by @metal3d in https://github.com/metal3d/katenary/pull/79
- Add katenary schema, cleanup and refactorization by @metal3d in https://github.com/metal3d/katenary/pull/81
- Some fixes on "same-pod" and volumes + add some tests by @metal3d in https://github.com/metal3d/katenary/pull/82
- test(codecov): remove codecov by @metal3d in https://github.com/metal3d/katenary/pull/85
- Add "values-from" and more tests by @metal3d in https://github.com/metal3d/katenary/pull/86
- Add schema to the root, fix test coverage by @metal3d in https://github.com/metal3d/katenary/pull/87
- Enhance doc, description, examples by @metal3d in https://github.com/metal3d/katenary/pull/88
- Use develop branch please by @metal3d in https://github.com/metal3d/katenary/pull/90
- Fix binary data, Add tests, Error management by @metal3d in https://github.com/metal3d/katenary/pull/91
- doc(refresh): Refresh doc after changing functions by @metal3d in https://github.com/metal3d/katenary/pull/92
Full Changelog: https://github.com/metal3d/katenary/compare/v3.0.0-rc1...3.0.0-rc2
Downloads
-
2024-11-26 23:04:06 +00:00 | 212 commits to master since this releaseThis version is a complete rewrite, no-compatible with v2.
What's Changed
- Complete rewrite
- The generated Helm Chart is, or "should be", complete and no need for changes for a large majority of compose projects
- We are now able to manage static files in
configMaps(to use only with configuration content, do not use this to manage sources) - Add nice features as capturing values from a service environment to link them in another one - or share an
emptyDirand use a command to synchronize files - Many fixes on how the compose files are managed
- A new way to manage values is using a
katenary.yamlinstead of using labels (labels override the values from katenary.yaml) - And so much to say that the documentation will tell you, which makes version 2 prehistoric 😉
Thanks to all contributors!
Important: some features may change from this release to the next one, especially concerning the katenary.yaml file.
New Contributors
- @iThom made their first contribution in https://github.com/metal3d/katenary/pull/22
- @samzong made their first contribution in https://github.com/metal3d/katenary/pull/40
- @YoranSys made their first contribution in https://github.com/metal3d/katenary/pull/32
Full Changelog: https://github.com/metal3d/katenary/compare/2.0.0-beta2...v3.0.0-rc1
Downloads
-
v2.0.0-beta2 Stable
2022-05-24 09:19:10 +00:00 | 392 commits to master since this releaseThis release fixes some problems
- Fix the problem with environment as secret #17
- Fix problems with local volumes to configmap
- Trim space on port label (#14)
- Ignore comment prefix in envfiles (#15)
Thanks to @adrian-salas
Downloads
-
v2.0.0-beta1 Stable
2022-05-08 08:00:48 +00:00 | 401 commits to master since this releaseThis release uses https://github.com/compose-spec/compose-go to enhance syntax support
Add labels:
volume-from(withsame-pod) to avoid volume repetitionignoreto ignore a servicemapenv(replaces theenv-to-service) to map environment to helm variable (as a template string)secret-varsdeclares variables as secret values
Many improvements of generated helm chart (better version check in ingress, values.yaml file now set environment)
Warning:
- the
env-to-servicelabel is DEPRECATED and IGNORED (a warning appears on the console to help to fix)
Downloads