# 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 ```sh sudo av install brew:butane ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install butane ``` Evidence: local Homebrew formula metadata - MacPorts (94%): ```sh sudo port install butane ``` Evidence: MacPorts ports tree: sysutils/butane/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 ### Linux - apk (92%): ```sh sudo apk add butane ``` Evidence: Alpine Linux edge package indexes: butane from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz - dnf (92%): ```sh sudo dnf install butane ``` Evidence: Fedora Rawhide package metadata: butane from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst - Nix (92%): ```sh nix profile install nixpkgs#butane ``` Evidence: nixpkgs package indexes: pkgs/by-name/bu/butane/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - zypper (92%): ```sh sudo zypper install butane ``` Evidence: openSUSE Tumbleweed package metadata: butane from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst ### Windows - Scoop (92%): ```sh scoop install extras/butane ``` Evidence: Scoop official bucket manifest trees: bucket/butane.json from https://api.github.com/repos/ScoopInstaller/Extras/git/trees/master?recursive=1 - winget (92%): ```sh winget install --id Fedora.CoreOS.butane -e ``` Evidence: Windows Package Manager source index: Fedora.CoreOS.butane from https://cdn.winget.microsoft.com/cache/source.msix ## Package facts - **Package key:** brew:butane - **Package manager:** Homebrew - **Package manager page:** - **Version:** 0.29.0 - **Source summary:** Translates human-readable Butane Configs into machine-readable Ignition Configs - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** Apache-2.0 - **Source archive:** - **Last updated:** 2026-07-07T21:31:40Z - **Generated:** 2026-07-08T07:18:31+00:00 ## Executables - butane (cli) - butane (alias) ## Build dependencies - go ## Install behavior - Post-install hook: not defined - Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux ## Freshness - Page generated: 2026-07-08 - Package-manager version: 0.29.0 - Package-manager updated: 2026-07-07 - Local data: ok - Upstream repository: https://github.com/coreos/butane - Upstream latest detected: v0.29.0 (current) ## 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. ### Sources - - - - - source_facts.package-manager ## Security Notes narrow executable package without higher-risk signals. - **Geiger risk:** green / low - narrow executable package without higher-risk signals ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** butane - **Version Scheme:** 0 - **Revision:** 0 - **Head Version:** HEAD - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** head, stable ## Other Package-Manager Records - Nix - butane: normalized package name match | nixpkgs package indexes: pkgs/by-name/bu/butane/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - apk - butane - 0.28.0-r0: normalized package name match | Alpine Linux edge package indexes: butane from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | Butane to Ignition config generator | https://github.com/coreos/butane - dnf - butane - 0.28.0-2.fc45: normalized package name match | Fedora Rawhide package metadata: butane from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | Butane config transpiler | https://github.com/coreos/butane - dnf - butane-redistributable - 0.28.0-2.fc45: normalized package name match | 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 | Statically built Butane for Linux, macOS and Windows | https://github.com/coreos/butane - zypper - butane - 0.27.0-1.2: normalized package name match | openSUSE Tumbleweed package metadata: butane from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Tool to generate Ignition configs from Butane Configs | https://github.com/coreos/butane - MacPorts - butane: normalized package name match | MacPorts ports tree: sysutils/butane/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 - Scoop - extras/butane: normalized package name match | Scoop official bucket manifest trees: bucket/butane.json from https://api.github.com/repos/ScoopInstaller/Extras/git/trees/master?recursive=1 - winget - Fedora.CoreOS.butane: normalized package name match | Windows Package Manager source index: Fedora.CoreOS.butane from https://cdn.winget.microsoft.com/cache/source.msix ## Related links - [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family. - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata. - [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata. - [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew. - [config-file-validator](https://www.automicvault.com/pkg/brew/config-file-validator/) - Shares av.db curated category or tags: cli, configuration, developer-tools, yaml. - [dhall-json](https://www.automicvault.com/pkg/brew/dhall-json/) - Shares av.db curated category or tags: cli, configuration, developer-tools, yaml. - [ytt](https://www.automicvault.com/pkg/brew/ytt/) - Shares av.db curated category or tags: cli, configuration, developer-tools, yaml. - [dhall-bash](https://www.automicvault.com/pkg/brew/dhall-bash/) - Shares av.db curated category or tags: cli, configuration, developer-tools. - [dynaconf](https://www.automicvault.com/pkg/brew/dynaconf/) - Shares av.db curated category or tags: cli, configuration, developer-tools. - [editorconfig](https://www.automicvault.com/pkg/brew/editorconfig/) - Shares av.db curated category or tags: cli, configuration, developer-tools. - [envelope](https://www.automicvault.com/pkg/brew/envelope/) - Shares av.db curated category or tags: cli, configuration, developer-tools. - [envio](https://www.automicvault.com/pkg/brew/envio/) - Shares av.db curated category or tags: cli, configuration, developer-tools. ## Combined YAML source View the package source record on GitHub. [combined/butane.yml](https://github.com/automic-vault/db/blob/main/combined/butane.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated package history - package version freshness - av.db category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph