← Package directory
Available on winget

Install butane

Butane translates human-readable Butane Configs into machine-readable Ignition Configs.

Install with winget
winget install --id Fedora.CoreOS.butane
Upgrade
winget upgrade --id Fedora.CoreOS.butane
Uninstall
winget uninstall --id Fedora.CoreOS.butane

About butane

Butane (formerly the Fedora CoreOS Config Transpiler, FCCT) translates human readable Butane Configs into machine readable Ignition Configs.

What's new in 0.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+)

Read release notes

Version history

Version Updated Notes
0.28.0 Unknown 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...
0.27.0 Unknown 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 ta...
0.26.0 Unknown 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, targ...
0.25.1 Unknown 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
0.25.0 Unknown 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...
0.24.0 Unknown 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...
0.23.0 Unknown Butane 0.23.0 (2024-12-03) Starting with this release, Butane binaries are signed with the Fedora 41 key.Features - Add OpenShift spec 4.19.0-experimental, targeting Ignition spec 3.6.0-experimental - Stabilize OpenShift...
0.22.0 Unknown 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 gr...
0.21.0 Unknown 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, targ...
0.20.0 Unknown Starting with this release, Butane binaries are signed with the Fedora 39 key.Features - Support s390x layouts in boot_device section (fcos 1.6.0-exp, openshift 4.15.0-exp) - Stabilize OpenShift spec 4.15.0, targeting Ig...
0.19.0 Unknown Breaking changes - Spec implementations require a FieldFilters() method (Go API) - Reports from Unvalidated functions can now include json paths (Go API) Features - Add -c/--check option to check config without producing...
0.18.0 Unknown Release notes
0.17.0 Unknown No notes
0.16.0 Unknown Release notes
0.15.0 Unknown No notes