v0.29.0

Breaking changes

Roll back OpenShift spec 4.22.0 to Ignition spec 3.5.0. Butane 0.28.0 stabilized 4.22.0 targeting Ignition 3.6.0 (#704), but OCP 4.22's Machine Config Operator does not support Ignition 3.6.0 (OCPBUGS-90256). Configs must be re-transpiled with an updated Butane.

Misc. changes

Add support for pretty error reporting, can be controlled through the use of --raw-errors (disable) and --color/--colour

v0.28.0

Starting with this release, Butane binaries are signed with the Fedora 44
key.

Features

• Stabilize OpenShift spec 4.22.0, targeting Ignition spec 3.6.0
• Add OpenShift spec 4.23.0-experimental, targeting Ignition spec 3.7.0-experimental
• Add systemd.quadlets section for embedding Podman Quadlet files (fcos 1.8.0-exp, fiot 1.1.0-exp, flatcar 1.2.0-exp, openshift 4.23.0-exp, r4e 1.2.0-exp)

Misc. changes

• Warn on root partition size is too small (fcos 1.3.0+)
• Warn on root partition constrained by another partition (fcos 1.3.0+)

v0.27.0

Butane 0.27.0 (2026-02-27)

Features

• Stabilize Fcos spec 1.7.0, targeting Ignition spec 3.6.0
• Add Fcos spec 1.8.0-experimental, targeting Ignition spec 3.7.0-experimental
• Update Flatcar spec 1.2.0-experimental to target Ignition spec 3.7.0-experimental
• Update Fiot spec 1.1.0-experimental to target Ignition spec 3.7.0-experimental
• Update R4E spec 1.2.0-experimental to target Ignition spec 3.7.0-experimental
• Update OpenShift spec 4.22.0-experimental to target Ignition spec 3.7.0-experimental

Docs changes

• Re-vendor latest ignition release; 3.6.0-experimental becomes 3.6.0

v0.26.0

Starting with this release, Butane binaries are signed with the Fedora 43
key.

Breaking changes

• Require boot_device.layout when using boot_device.mirror (fcos 1.7.0-exp)

Features

• Stabilize OpenShift spec 4.21.0, targeting Ignition spec 3.5.0
• Add OpenShift spec 4.22.0-experimental, targeting Ignition spec
  3.6.0-experimental
• Add support for mode and ownership settings for trees.

Bug fixes

• Warn for boot_device.layout to be specified when using boot_device.mirror (fcos 1.3.0-1.6.0)

Docs changes

• Update boot_device.mirror examples to specify boot_device.layout

v0.25.1

Docs changes

• Update docs around the use of setuid/gid from Ignition bug

Misc. changes

• Update vendor'd Ignition dependency to point to latest v2.23.0

v0.25.0

Features

• Stabilize OpenShift spec 4.20.0, targeting Ignition spec 3.5.0
• Add OpenShift spec 4.21.0-experimental, targeting Ignition spec 3.6.0-experimental

Bug fixes

• Stop overriding default LUKS cipher algorithm in FIPS mode (openshift 4.20.0)

Docs changes

• Add missing examples in upgrading-openshift (openshift 4.14)

v0.24.0

Errata: This release was signed with the Fedora 42 key. Starting with this release, Butane binaries are signed with the Fedora 42 key.

Features

• Validate merged/replaced Ignition configs if they are local/inline (all base specifications)
• Stabilize OpenShift spec 4.19.0, targeting Ignition spec 3.5.0
• Add OpenShift spec 4.20.0-experimental, targeting Ignition spec
  3.6.0-experimental

Bug fixes

• Fail if LUKS method is not specified while boot_device.luks.device is set (fcos 1.7.0-exp)
• Validate kernel arguments when CEX support is enabled on s390x (4.19.0 and 4.20.0-experimental)

Misc. changes

• Roll back to Ignition spec 3.5.0 (openshift 4.19.0)

v0.23.0

Butane 0.23.0 (2024-12-03)

Starting with this release, Butane binaries are signed with the Fedora 41 key.

Errata: This release was signed with the Fedora 40 key. The next releases will be signed with the Fedora 41 one.

Features

• Add OpenShift spec 4.19.0-experimental, targeting Ignition spec
  3.6.0-experimental
• Stabilize OpenShift spec 4.18.0, targeting Ignition spec 3.4.0
• Stabilize Fcos spec 1.6.0, targeting Ignition spec 3.5.0
• Add Fcos spec 1.7.0-experimental, targeting Ignition spec
  3.6.0-experimental
• Update Fiot spec 1.1.0-experimental to target Ignition spec
  3.6.0-experimental
• Update Flatcar spec 1.2.0-experimental to target Ignition spec
  3.6.0-experimental
• Update OpenShift spec 4.18.0-experimental, targeting Ignition spec
  3.6.0-experimental
• Update R4e spec 1.2.0-experimental to target Ignition spec
  3.6.0-experimental
• Support LUKS encryption using IBM CEX secure keys on s390x (fcos 1.6) (openshift 4.18.0-exp)

Docs changes

• Re-vendor latest ignition release; 3.5.0-experimental becomes 3.5.0

v0.22.0

Butane 0.22.0 (2024-09-20)

Features

• Stabilize OpenShift spec 4.17.0, targeting Ignition spec 3.4.0
• Add OpenShift spec 4.18.0-experimental, targeting Ignition spec
  3.5.0-experimental
• Support and documentation for grub section moved to OpenShift
  4.18.0-experimental spec.

Misc. changes

• Roll back to Ignition spec 3.4.0 (openshift 4.17.0)

v0.21.0

Butane 0.21.0 (2024-06-06)

Starting with this release, Butane binaries are signed with the Fedora 40
key.

Breaking changes

Features

• Support storage.luks.clevis (flatcar 1.2.0-exp)
• Stabilize OpenShift spec 4.16.0, targeting Ignition spec 3.4.0
• Add OpenShift spec 4.17.0-experimental, targeting Ignition spec
  3.5.0-experimental