# 使用 Homebrew, apk, dnf, MacPorts, Nix, zypper, scoop, winget 安装 butane

查看 butane 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。

## 安装

```sh
sudo av install brew:butane
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install butane
```

  证据: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install butane
```

  证据: 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
```

  证据: 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
```

  证据: Fedora Rawhide package metadata: butane from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/07190dc5ae9f35ae73866675fed6d95fe6e8d9fe22c9d7cdf85862cb2ed24a4c-primary.xml.zst

- Nix (92%):

```sh
nix profile install nixpkgs#butane
```

  证据: 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
```

  证据: openSUSE Tumbleweed package metadata: butane from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst

### Windows

- Scoop (92%):

```sh
scoop install extras/butane
```

  证据: 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
```

  证据: Windows Package Manager source index: Fedora.CoreOS.butane from https://cdn.winget.microsoft.com/cache/source.msix

## 软件包事实

- **软件包键:** brew:butane
- **软件包管理器:** Homebrew
- **版本:** 0.29.0
- **来源摘要:** Translates human-readable Butane Configs into machine-readable Ignition Configs
- **主页:** <https://coreos.github.io/butane/>
- **仓库:** <https://github.com/coreos/butane>
- **最后更新:** 2026-07-07T21:31:40Z
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- butane (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

- 页面生成时间: 2026-08-03
- 管理器版本: 0.29.0
## 项目历史与用法

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.

### 项目历史

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.

### 采用历史

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.

### 使用方式

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.

### 为什么软件包爱好者会关心

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.

### 时间线

- 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.

### 来源

- <https://coreos.github.io/butane/getting-started>
- <https://coreos.github.io/butane/specs>
- <https://github.com/coreos/butane>
- <https://github.com/coreos/butane/blob/main/docs/development.md>
- source_facts.package-manager


## 安全说明

narrow executable package without higher-risk signals.

- **Geiger 风险:** 绿色 / 低
- narrow executable package without higher-risk signals

## 其他软件包管理器记录

- 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.29.0-r1: 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.29.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/07190dc5ae9f35ae73866675fed6d95fe6e8d9fe22c9d7cdf85862cb2ed24a4c-primary.xml.zst | Butane config transpiler | https://github.com/coreos/butane
- dnf - butane-redistributable - 0.29.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/07190dc5ae9f35ae73866675fed6d95fe6e8d9fe22c9d7cdf85862cb2ed24a4c-primary.xml.zst | Statically built Butane for Linux, macOS and Windows | https://github.com/coreos/butane
- zypper - butane - 0.27.0-1.5: normalized package name match | openSUSE Tumbleweed package metadata: butane from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-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


## Combined YAML source

View the package source record on GitHub. [combined/butane.yml](https://github.com/mxcl/pkgdb/blob/main/combined/butane.yml)


## 来源

- pkg.so package database
- Geiger risk classifier
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph
