werf
✕
Join the party at CNCF Slack
Step 1:
Get an invite to CNCF Slack
Step 2:
Join #werf channel
We've chosen CNCF Slack since most of the Kubernetes community members are there.
Changelog history of releases within channels
Release
2 1.2
Release channel
Rock-Solid Stable Early-Access Beta Alpha

For usage in critical environments with tight SLA

This is the most stable channel and recommended for usage in critical environments with tight SLA. We guarantee backward compatibility between Rock-Solid releases within minor branch (1.1.x). We guarantee that Stable release should become a Rock-Solid release not earlier than 2 weeks after broad testing.

v2.22.0
Feb 18, 2025 at 18:30 +0300

{% raw %}

Changelog

Features

  • deploy: add –kube-qps-limit and –kube-burst-limit flags, increase default QPS/Burst (71f79ef)
  • deploy: add –skip-tls-verify-kube, –kube-api-server, –kube-ca-path, –kube-tls-server, –kube-token, –skip-tls-verify-helm-dependencies options to bundles (a2a810c)
  • kube-run: support %container_image% in overrides (#6553) (c3ab1aa)

Installation

To install werf we strongly recommend following these instructions.

Alternatively, you can download werf binaries from here:

These binaries were signed with PGP and could be verified with the werf PGP public key. For example, werf binary can be downloaded and verified with gpg on Linux with these commands:

curl -sSLO "https://tuf.werf.io/targets/releases/2.22.0/linux-amd64/bin/werf" -O "https://tuf.werf.io/targets/signatures/2.22.0/linux-amd64/bin/werf.sig"  
curl -sSL https://werf.io/werf.asc | gpg --import  
gpg --verify werf.sig werf

{% endraw %}

Recommended channel

Stable channel releases are mostly safe to use and we encourage to use this channel everywhere. We guarantee backward compatibility between Stable releases within minor branch (1.1.x). We guarantee that Early-Access release should become Stable not earlier than 2 weeks after internal testing.

v2.27.1
Feb 18, 2025 at 18:30 +0300

{% raw %}

Changelog

Bug Fixes

  • build, buildah, dockerfile, staged: fix : no found (invalid PATH) ([d667dc3](https://www.github.com/werf/werf/commit/d667dc38a6ef7b7be7363e0213a1937027d4f5cb))

Installation

To install werf we strongly recommend following these instructions.

Alternatively, you can download werf binaries from here:

These binaries were signed with PGP and could be verified with the werf PGP public key. For example, werf binary can be downloaded and verified with gpg on Linux with these commands:

curl -sSLO "https://tuf.werf.io/targets/releases/2.27.1/linux-amd64/bin/werf" -O "https://tuf.werf.io/targets/signatures/2.27.1/linux-amd64/bin/werf.sig"  
curl -sSL https://werf.io/werf.asc | gpg --import  
gpg --verify werf.sig werf

{% endraw %}

For use in non critical environments or local development

These releases are mostly safe to use and can even be used in non critical environments or for local development. We do not guarantee backward compatibility between Early-Access releases.

v2.27.1
Feb 18, 2025 at 18:30 +0300

{% raw %}

Changelog

Bug Fixes

  • build, buildah, dockerfile, staged: fix : no found (invalid PATH) ([d667dc3](https://www.github.com/werf/werf/commit/d667dc38a6ef7b7be7363e0213a1937027d4f5cb))

Installation

To install werf we strongly recommend following these instructions.

Alternatively, you can download werf binaries from here:

These binaries were signed with PGP and could be verified with the werf PGP public key. For example, werf binary can be downloaded and verified with gpg on Linux with these commands:

curl -sSLO "https://tuf.werf.io/targets/releases/2.27.1/linux-amd64/bin/werf" -O "https://tuf.werf.io/targets/signatures/2.27.1/linux-amd64/bin/werf.sig"  
curl -sSL https://werf.io/werf.asc | gpg --import  
gpg --verify werf.sig werf

{% endraw %}

For more broad testing of new features

These releases are for more broad testing of new features to catch regressions. We do not guarantee backward compatibility between Beta releases.

v2.27.1
Feb 18, 2025 at 18:30 +0300

{% raw %}

Changelog

Bug Fixes

  • build, buildah, dockerfile, staged: fix : no found (invalid PATH) ([d667dc3](https://www.github.com/werf/werf/commit/d667dc38a6ef7b7be7363e0213a1937027d4f5cb))

Installation

To install werf we strongly recommend following these instructions.

Alternatively, you can download werf binaries from here:

These binaries were signed with PGP and could be verified with the werf PGP public key. For example, werf binary can be downloaded and verified with gpg on Linux with these commands:

curl -sSLO "https://tuf.werf.io/targets/releases/2.27.1/linux-amd64/bin/werf" -O "https://tuf.werf.io/targets/signatures/2.27.1/linux-amd64/bin/werf.sig"  
curl -sSL https://werf.io/werf.asc | gpg --import  
gpg --verify werf.sig werf

{% endraw %}

Least stable release channel

These releases can bring new features, but are unstable. We do not guarantee backward compatibility between Alpha releases.

v2.27.1
Feb 18, 2025 at 18:30 +0300

{% raw %}

Changelog

Bug Fixes

  • build, buildah, dockerfile, staged: fix : no found (invalid PATH) ([d667dc3](https://www.github.com/werf/werf/commit/d667dc38a6ef7b7be7363e0213a1937027d4f5cb))

Installation

To install werf we strongly recommend following these instructions.

Alternatively, you can download werf binaries from here:

These binaries were signed with PGP and could be verified with the werf PGP public key. For example, werf binary can be downloaded and verified with gpg on Linux with these commands:

curl -sSLO "https://tuf.werf.io/targets/releases/2.27.1/linux-amd64/bin/werf" -O "https://tuf.werf.io/targets/signatures/2.27.1/linux-amd64/bin/werf.sig"  
curl -sSL https://werf.io/werf.asc | gpg --import  
gpg --verify werf.sig werf

{% endraw %}

Release channel
Rock-Solid Stable Early-Access Beta Alpha

For usage in critical environments with tight SLA

This is the most stable channel and recommended for usage in critical environments with tight SLA. We guarantee backward compatibility between Rock-Solid releases within minor branch (1.1.x). We guarantee that Stable release should become a Rock-Solid release not earlier than 2 weeks after broad testing.

v1.2.10+fix27
Jan 26, 2022 at 20:49 +0300

{% raw %}# Features

  • [compose] docker-compose run command support

  • [compose] Support for positional arguments to build and forward

specific images

If one or more IMAGE_NAME parameters specified, werf will build and

forward only these images

  
  werf compose up [IMAGE_NAME...] [options] [--docker-compose-options="OPTIONS"] [--docker-compose-command-options="OPTIONS"] [--] [SERVICE...]

Fixes

  • [compose] Fix certain service names specified by the user are ignored

  • [container registry] Fix processing of reference with digest

    The user may have encountered related issues when using the base image

(from) with digest (REPO@DIGEST, REPO:TAG@DIGEST).

  
  WARNING: cannot get base image id (alpine@sha256:69e70a79f2d41ab5d637de98c1e0b055206ba40a8145e7bddb55ccc04e13cf8f): can not get base image id from registry (alpine@sha256:69e70a79f2d41ab5d637de98c1e0b055206ba40a8145e7bddb55ccc04e13cf8f): repository can only contain the runes `abcdefghijklmnopqrstuvwxyz0123456789_-./`: alpine@sha256
  
  WARNING: using existing image alpine@sha256:69e70a79f2d41ab5d637de98c1e0b055206ba40a8145e7bddb55ccc04e13cf8f without pull

Documentation

  • [docs] CI/CD / GitHub Actions: update taking off label step

Internals

  • [git_repo] Move common methods from git_repo local/remote to base

  • [conveyor] Refactoring of werf config images processing

  • Improvements related to tests, coverage, and GitHub Actions workflows

Installation

Linux amd64

Darwin amd64

Windows amd64

{% endraw %}

Recommended channel

Stable channel releases are mostly safe to use and we encourage to use this channel everywhere. We guarantee backward compatibility between Stable releases within minor branch (1.1.x). We guarantee that Early-Access release should become Stable not earlier than 2 weeks after internal testing.

v1.2.10+fix27
Dec 3, 2021 at 18:01 +0300

{% raw %}# Features

  • [compose] docker-compose run command support

  • [compose] Support for positional arguments to build and forward

specific images

If one or more IMAGE_NAME parameters specified, werf will build and

forward only these images

  
  werf compose up [IMAGE_NAME...] [options] [--docker-compose-options="OPTIONS"] [--docker-compose-command-options="OPTIONS"] [--] [SERVICE...]

Fixes

  • [compose] Fix certain service names specified by the user are ignored

  • [container registry] Fix processing of reference with digest

    The user may have encountered related issues when using the base image

(from) with digest (REPO@DIGEST, REPO:TAG@DIGEST).

  
  WARNING: cannot get base image id (alpine@sha256:69e70a79f2d41ab5d637de98c1e0b055206ba40a8145e7bddb55ccc04e13cf8f): can not get base image id from registry (alpine@sha256:69e70a79f2d41ab5d637de98c1e0b055206ba40a8145e7bddb55ccc04e13cf8f): repository can only contain the runes `abcdefghijklmnopqrstuvwxyz0123456789_-./`: alpine@sha256
  
  WARNING: using existing image alpine@sha256:69e70a79f2d41ab5d637de98c1e0b055206ba40a8145e7bddb55ccc04e13cf8f without pull

Documentation

  • [docs] CI/CD / GitHub Actions: update taking off label step

Internals

  • [git_repo] Move common methods from git_repo local/remote to base

  • [conveyor] Refactoring of werf config images processing

  • Improvements related to tests, coverage, and GitHub Actions workflows

Installation

Linux amd64

Darwin amd64

Windows amd64

{% endraw %}

For use in non critical environments or local development

These releases are mostly safe to use and can even be used in non critical environments or for local development. We do not guarantee backward compatibility between Early-Access releases.

v1.2.10+fix27
May 21, 2021 at 18:23 +0300

{% raw %}# Features

  • [compose] docker-compose run command support

  • [compose] Support for positional arguments to build and forward

specific images

If one or more IMAGE_NAME parameters specified, werf will build and

forward only these images

  
  werf compose up [IMAGE_NAME...] [options] [--docker-compose-options="OPTIONS"] [--docker-compose-command-options="OPTIONS"] [--] [SERVICE...]

Fixes

  • [compose] Fix certain service names specified by the user are ignored

  • [container registry] Fix processing of reference with digest

    The user may have encountered related issues when using the base image

(from) with digest (REPO@DIGEST, REPO:TAG@DIGEST).

  
  WARNING: cannot get base image id (alpine@sha256:69e70a79f2d41ab5d637de98c1e0b055206ba40a8145e7bddb55ccc04e13cf8f): can not get base image id from registry (alpine@sha256:69e70a79f2d41ab5d637de98c1e0b055206ba40a8145e7bddb55ccc04e13cf8f): repository can only contain the runes `abcdefghijklmnopqrstuvwxyz0123456789_-./`: alpine@sha256
  
  WARNING: using existing image alpine@sha256:69e70a79f2d41ab5d637de98c1e0b055206ba40a8145e7bddb55ccc04e13cf8f without pull

Documentation

  • [docs] CI/CD / GitHub Actions: update taking off label step

Internals

  • [git_repo] Move common methods from git_repo local/remote to base

  • [conveyor] Refactoring of werf config images processing

  • Improvements related to tests, coverage, and GitHub Actions workflows

Installation

Linux amd64

Darwin amd64

Windows amd64

{% endraw %}

For more broad testing of new features

These releases are for more broad testing of new features to catch regressions. We do not guarantee backward compatibility between Beta releases.

v1.2.10+fix29
May 21, 2021 at 18:23 +0300

{% raw %}# Fixes

Fix werf-render command error shadowing and logging

  • Internal helm-dependency-build process error was shadowed and not affected anything.
  • werf render (--verbose|--debug) should enable verbose or debug mode, but it was not happened.

Installation

Linux amd64

Darwin amd64

Windows amd64

{% endraw %}

Least stable release channel

These releases can bring new features, but are unstable. We do not guarantee backward compatibility between Alpha releases.

v1.2.11+fix1
May 21, 2021 at 18:23 +0300

{% raw %}# Docs

[publication] Add recent publications

[docs] Advanced/Supported container registries: add Yandex Container Registry

Fixes

Fix werf does not load secret values files outside of helm chart dir

Installation

Linux amd64

Darwin amd64

Windows amd64

{% endraw %}

cncf logo
werf is a Cloud Native Computing Foundation sandbox project
flant logo
werf was originally created by Flant
The Linux Foundation® (TLF) has registered trademarks and uses trademarks. For a list of TLF trademarks, see Trademark Usage.