Automic VaultAutomic Vault

brew

Install butane with Homebrew, apk, dnf, MacPorts, Nix, scoop, winget, zypper

Translates human-readable Butane Configs into machine-readable Ignition Configs. Version 0.29.0 via Homebrew; verified 2026-07-07.

Install commandSecurity notes

install

Additional install commands

macOS

Homebrewverified · 100%
brew install butane

local Homebrew formula metadata

MacPortsverified · 94%
sudo port install butane

MacPorts ports tree · sysutils/butane/Portfile · source: api.github.com

Linux

Alpine Linux apkverified · 92%
sudo apk add butane

Alpine Linux edge package indexes · butane · source: dl-cdn.alpinelinux.org

Fedora dnfverified · 92%
sudo dnf install butane

Fedora Rawhide package metadata · butane · source: dl.fedoraproject.org

Nixverified · 92%
nix profile install nixpkgs#butane

nixpkgs package indexes · pkgs/by-name/bu/butane/package.nix · source: api.github.com

openSUSE zypperverified · 92%
sudo zypper install butane

openSUSE Tumbleweed package metadata · butane · source: download.opensuse.org

Windows

Scoopverified · 92%
scoop install extras/butane

Scoop official bucket manifest trees · bucket/butane.json · source: api.github.com

Windows Package Managerverified · 92%
winget install --id Fedora.CoreOS.butane -e

Windows Package Manager source index · Fedora.CoreOS.butane · source: cdn.winget.microsoft.com

overview

Package summary

Translates human-readable Butane Configs into machine-readable Ignition Configs

Commands and aliases

  • butane

history

Project history and usage

Butane is the Fedora CoreOS-era configuration transpiler that turns human-readable YAML-like Butane Configs into Ignition JSON. It sits in the provisioning path for Fedora CoreOS, Flatcar-style immutable host workflows, and other Ignition consumers where operators want reviewable source configuration without hand-writing low-level Ignition documents.

Project history

The project was originally known as the Fedora CoreOS Config Transpiler, or FCCT, and was later renamed Butane. Its README still describes that lineage directly: Butane was formerly FCCT and translates human-readable configs into machine-readable Ignition configs.

Butane tracks versioned config variants and Ignition spec versions. The development documentation describes separate versioned base and config packages, experimental spec versions, stabilization checklists, and a Fedora RPM-based release build process.

Adoption history

Butane became part of the Fedora CoreOS provisioning ecosystem because Fedora CoreOS machines are initialized through Ignition. It is packaged beyond Homebrew in Fedora, Nix, MacPorts, Scoop, winget, Alpine, and openSUSE according to the supplied package-manager facts, which reflects use by both Linux operators and workstation users preparing machine configs.

How it is used

A typical workflow is to write a Butane config, run the `butane` CLI to validate and translate it, and feed the generated Ignition config to a Fedora CoreOS or related machine at first boot. The official docs emphasize the getting-started guide and per-variant configuration specifications.

Why package nerds care

Butane is package-nerd interesting because it is not just a format converter: it encodes Fedora CoreOS and Ignition schema evolution into a small CLI that distributions can ship. Formula and distro maintainers care about its spec-version matrix, Go build process, and tight relationship with Ignition releases.

Timeline

  • 2019: v0.1.0 tag appears in the official Git repository.
  • 2020: The project continues under the Butane name after the FCCT era.
  • 2026: v0.28.0 tag appears in the official Git repository.

Related projects

  • Ignition is the machine-readable config format emitted by Butane.
  • Fedora CoreOS is the operating-system project most closely associated with Butane configs.
  • Fedora rpms/butane is the packaging repository described by the project development docs for released binaries.

security posture

Risk level: green

narrow executable package without higher-risk signals.

Risk classifier

green risk · low confidence · appliance

Why

  • narrow executable package without higher-risk signals

Signals

  • metadata:no-higher-risk-signals

Install behavior

  • No Homebrew post-install hook is recorded in formula metadata.
  • Homebrew bottle metadata is available for 6 platform targets.
  • Build metadata lists 1 build dependencies.

Recommended review

Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.

executables

Installed executables

CommandKindExposureNote
butanecliglobal executable

freshness

Version and freshness

These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.

page generated2026-07-08
manager version0.29.0
manager updated2026-07-07
local dataok
upstreamcurrent
latest detectedv0.29.0

https://github.com/coreos/butane

  • okNo freshness warnings were generated.

install metadata

Package metadata

Package keybrew:butane
Version0.29.0
Package managerHomebrew
Package manager pagehttps://formulae.brew.sh/formula/butane
Homepagehttps://coreos.github.io/butane/
Repositoryhttps://github.com/coreos/butane
Upstream docshttps://coreos.github.io/butane
LicenseApache-2.0
Source archivehttps://github.com/coreos/butane/archive/refs/tags/v0.29.0.tar.gz
Last updated2026-07-07T21:31:40Z
Pulseupdated
Build dependenciesgo
Bottleavailable (on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux)
Homebrew post-installnot defined
Servicenone declared

registry facts

Source database details

Source DatabaseHomebrew formula API
Taphomebrew/core
Full Namebutane
Version Scheme0
Revision0
Head VersionHEAD
Bottle Stable Root URLhttps://ghcr.io/v2/homebrew/core
Deprecatedno
Disabledno
Keg Onlyno
URL Keys
  • head
  • stable

source database matches

Other package-manager records

Matches are pulled from external package-manager indexes and kept separate from local Automic Vault package links.

Nix95%

butane

nix profile install nixpkgs#butane
  • normalized package name match
  • Matched by: Butane
nixpkgs package indexes · api.github.com · nixpkgs package indexes: pkgs/by-name/bu/butane/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
apk95%

butane 0.28.0-r0

Butane to Ignition config generator

https://github.com/coreos/butane

sudo apk add butane
  • License: Apache-2.0
  • Architecture: x86_64
  • Source Package: butane
  • 1 dependencies
  • 1 provides
  • normalized package name match
  • Matched by: Butane
Alpine Linux edge package indexes · dl-cdn.alpinelinux.org · Alpine Linux edge package indexes: butane from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz
dnf95%

butane 0.28.0-2.fc45

Butane config transpiler

https://github.com/coreos/butane

sudo dnf install butane
  • License: Apache-2.0
  • Category: Unspecified
  • Architecture: x86_64
  • Source Package: butane
  • 3 dependencies
  • 4 provides
  • normalized package name match
  • Matched by: Butane
Fedora Rawhide package metadata · dl.fedoraproject.org · Fedora Rawhide package metadata: butane from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst
dnf95%

butane-redistributable 0.28.0-2.fc45

Statically built Butane for Linux, macOS and Windows

https://github.com/coreos/butane

sudo dnf install butane-redistributable
  • License: Apache-2.0
  • Category: Unspecified
  • Architecture: noarch
  • Source Package: butane
  • 1 provides
  • normalized package name match
  • Matched by: Butane
Fedora Rawhide package metadata · dl.fedoraproject.org · Fedora Rawhide package metadata: butane-redistributable from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst
zypper95%

butane 0.27.0-1.2

Tool to generate Ignition configs from Butane Configs

https://github.com/coreos/butane

sudo zypper install butane
  • License: Apache-2.0
  • Category: System/Management
  • Architecture: x86_64
  • Source Package: butane
  • 1 dependencies
  • 2 provides
  • normalized package name match
  • Matched by: Butane
openSUSE Tumbleweed package metadata · download.opensuse.org · openSUSE Tumbleweed package metadata: butane from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst
MacPorts95%

butane

sudo port install butane
  • normalized package name match
  • Matched by: Butane
MacPorts ports tree · api.github.com · MacPorts ports tree: sysutils/butane/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1
Scoop95%

extras/butane

scoop install extras/butane
  • normalized package name match
  • Matched by: Butane
Scoop official bucket manifest trees · api.github.com · Scoop official bucket manifest trees: bucket/butane.json from https://api.github.com/repos/ScoopInstaller/Extras/git/trees/master?recursive=1
winget95%

Fedora.CoreOS.butane

winget install --id Fedora.CoreOS.butane -e
  • normalized package name match
  • Matched by: Butane
Windows Package Manager source index · cdn.winget.microsoft.com · Windows Package Manager source index: Fedora.CoreOS.butane from https://cdn.winget.microsoft.com/cache/source.msix

package graph

Links come from deterministic package relationships, av.db category and tag curation, ecosystem matches, and package hub membership.

Related tools

  • goBuild dependency declared by Homebrew.

Same workflow

  • config-file-validatorShares av.db curated category or tags: cli, configuration, developer-tools, yaml.
  • dhall-jsonShares av.db curated category or tags: cli, configuration, developer-tools, yaml.
  • yttShares av.db curated category or tags: cli, configuration, developer-tools, yaml.
  • dhall-bashShares av.db curated category or tags: cli, configuration, developer-tools.
  • dynaconfShares av.db curated category or tags: cli, configuration, developer-tools.
  • editorconfigShares av.db curated category or tags: cli, configuration, developer-tools.

source trail

Generated from repository data

This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.

Used sources

  • Geiger risk classifier
  • Nucleus package database
  • av.db category and tag curation
  • cross-ecosystem install command graph
  • curated package history
  • external package-manager database matches
  • package relationship graph
  • package version freshness
  • package-page enrichment