butane

Fedora Project·Fedora.CoreOS.butane

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

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

winget install --id Fedora.CoreOS.butane --exact --source winget

Latest 2.27.0·September 1, 2026

Release Notes

Starting with this release, ignition-validate binaries are signed with the Fedora 44 key. Breaking changes

  • The build script now requires a subcommand (ignition, ignition-validate, or ignition-validate-cross). Sourcing the build script is no longer supported.
  • Build and install are separate steps with explicit targets (ignition, ignition-validate, ignition-validate-cross, install, install-ignition-validate-cross, install-grub-for-bootupd). Features
  • Accept Butane YAML configs in addition to Ignition JSON, with automatic transpilation at boot (#2235)
  • Support reading configs from /run/ignition and /etc/ignition/ in addition to /usr/lib/ignition/, searched in descending priority order (#2221)
  • Add support for virtiofs
  • Support loading Ignition config from a labeled device via ignition.config.device and ignition.config.path kernel command-line arguments
  • Allow deleting a disk partition while creating another partition with number 0. (#2234) Changes
  • Merge Butane config transpiler into the Ignition repository; the butane CLI is now built from the Ignition source tree (#2235)
  • Replace GCS client library with direct HTTP calls to the GCS JSON API, significantly reducing binary size (#2045)
  • Refactored the Makefile and build script to match the Fedora RPM spec: separate build targets per binary, with VERSION and linker flags passed in at build time
  • build_blackbox_tests builds a blackbox-specific ignition binary with make
  • CI and GitHub Actions updated to build via make ignition and make ignition-validate
  • Fix test script compatibility with Go 1.26 which removed the -go flag from go tool fix
  • Improved documentation for the flow of Ignition across clouds. Bug fixes
  • Fix giving disk partition number 0 to get the next available slot. This caused the disks stage to fail since version 2.20.0. (#2234)
  • Fix disk partitioning race condition where the kernel is already aware of the changes before running partx, causing a fatal error. (#2234)
  • Add x-initrd.attach to crypttab entries to fix soft-reboot with LUKS (#2219)

Installer type: portable

x64—E990C186E321C25E748830A776800D8FC38E3B1981208A412541C1A8C870151E

Details

Homepage
https://github.com/coreos/ignition#butane
License
Apache-2.0
Publisher
Fedora Project
Support
https://github.com/coreos/ignition/issues
Moniker
butane

Tags

bashclicoreosdevops-toolsfcctfcosflatcargolangignitionopenshiftportabler4e

Older versions (16)

0.29.0
x64—B4966A4C4DBE4DD66DE3AB593F557C8030C8A0B945285D83AE7930E72B05A678
0.28.0
x64—2E1679624D45D7BE1636C0104CAC536215F9A8426FA94ECF2E3B778D521DF20A
0.27.0
x64—CB5F5DE9F525DA368C015D0386251D122D570FD702609BB0FCD2FD705430BF79
0.26.0
x64—261E3F1370F2467975D09D596094F2F6E8C78823EF63C4DDDB37612ADFF0B670
0.25.1
x64—E58FF06F02362E604866A25785D2FCB24DF7740CE8868E49C4A858AE81F7CF08
0.25.0
x64—394B05696D605F8FE2C144BE2F4639E2E8D0842BF15B6F0EE99C812BD62098BD
0.24.0
x64—48EF3CA442AC5B4E2D2DDF940969EDAEC644A84783EE87ABE73ABF07464DF717
0.23.0
x64—C83CD8BD53090A810C24ECAAA3D9A4E15225484E79197593FA03A26EFDC63D95
0.22.0
x64—CA4278C07E6507717A7A80A575F71B110B7E40705061E88B6DB7F8C8092465E0
0.21.0
x64—79F7E2A17E33DA4516F7CCA92E1CC330906B53AA663891CAE945FA8D4371FE23
0.20.0
x64—A9300038909968A6DE5EDF3725AA35261E11661B43CB4E40CDD600AD8F5CE3C9
0.19.0
x64—EFE21A5F0CDB33D99A2CD8613226B4D18F6AF658DBCF82AD71FC24C9BA1B1E28
0.18.0
x64—6F15EFA3DF781EC1ECAD895F778BCA5D9689B60110288AC7566F224215A93D10
0.17.0
x64—AB0A92F8810711F4B07D5339775B50C96633B9BA96B879ECE6989B362E45E58C
0.16.0
x64—3CD615B240A4BEF368DBE7AB60084A27E47FDF67B70859D3F6F31F9EA1E460DB
0.15.0
x64—FB30F4C36EADBE0DC635825BAF10086650DC1D917711F21CB29118EEADE5098A