# Install bitcoin with Homebrew, apk, chocolatey, MacPorts, Nix, zypper, pacman

Decentralized, peer to peer payment network. Version 31.0 via Homebrew; verified 2026-05-10.

## Install

```sh
sudo av install brew:bitcoin
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install bitcoin
```

  Evidence: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install bitcoin
```

  Evidence: MacPorts ports tree: finance/bitcoin/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- apk (92%):

```sh
sudo apk add bitcoin
```

  Evidence: Alpine Linux edge package indexes: bitcoin from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz

- Nix (92%):

```sh
nix profile install nixpkgs#bitcoin
```

  Evidence: nixpkgs package indexes: pkgs/by-name/bi/bitcoin/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

- zypper (92%):

```sh
sudo zypper install bitcoin-qt6
```

  Evidence: openSUSE Tumbleweed package metadata: bitcoin-qt6 from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst

- pacman (92%):

```sh
sudo pacman -S bitcoin-daemon
```

  Evidence: Arch Linux sync databases: bitcoin-daemon from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz

### Windows

- Chocolatey (92%):

```sh
choco install bitcoin
```

  Evidence: Chocolatey community package catalog: bitcoin from http://community.chocolatey.org/api/v2/Packages?$filter=IsLatestVersion&$select=Id&$top=1000&$skiptoken='6.9919996','gmkvextractgui'

## Package facts

- **Package key:** brew:bitcoin
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/bitcoin>
- **Version:** 31.0
- **Source summary:** Decentralized, peer to peer payment network
- **Homepage:** <https://bitcoincore.org/>
- **Repository:** <https://github.com/bitcoin/bitcoin>
- **Upstream docs:** <https://bitcoincore.org/en/doc>
- **License:** MIT AND BSD-3-Clause AND BSL-1.0
- **Source archive:** <https://bitcoincore.org/bin/bitcoin-core-31.0/bitcoin-31.0.tar.gz>
- **Last updated:** 2026-05-10T22:44:36-04:00
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- bitcoin (cli)
- bitcoin-cli (cli)
- bitcoin-tx (cli)
- bitcoin-util (cli)
- bitcoin-wallet (cli)
- bitcoind (cli)
- bitcoin (alias)
- bitcoin-cli (alias)
- bitcoin-tx (alias)
- bitcoin-util (alias)
- bitcoin-wallet (alias)
- bitcoind (alias)

## Dependencies

- capnp
- libevent
- zeromq

## Build dependencies

- boost
- cmake
- pkgconf

## Uses from macOS

- sqlite

## Install behavior

- Post-install hook: not defined
- Service: declared
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 31.0
- Package-manager updated: 2026-05-10
- Local data: ok
- Upstream repository: https://bitcoincore.org/
- info: Release/tag comparison is only available for GitHub repositories.
## Project history and usage

Bitcoin Core is the reference full-node implementation for the Bitcoin network. It descends directly from Satoshi Nakamoto's original Bitcoin client and packages the network node, wallet, RPC tools, transaction utilities, validation engine, and supporting documentation used by operators, developers, exchanges, researchers, and packagers.

### Project history

Bitcoin Core's About page describes it as the open-source project that maintains and releases Bitcoin client software, and as a direct descendant of the original client released by Satoshi Nakamoto after the Bitcoin whitepaper. The current repository is the integration and staging tree for that software.

The software evolved from a combined GUI wallet and peer-to-peer node into a suite of command-line and GUI programs: `bitcoind` for daemonized full-node operation, `bitcoin-cli` for RPC calls, `bitcoin-tx` for transaction construction, `bitcoin-wallet` for wallet maintenance, and related utilities. The official README emphasizes full validation of blocks and transactions.

Major engineering milestones show the project adapting to scale and operational risk. The 0.8.0 release moved block and transaction indices to LevelDB, changed indexing defaults, added performance work for validation, and supported Bloom filters for lightweight clients. Later releases added network privacy and transport work, wallet changes, RPC evolution, and continuing platform support.

### Adoption history

Bitcoin Core became the default implementation against which much of the Bitcoin ecosystem measures consensus behavior, because full nodes independently validate blocks and transactions. Its correctness and review process matter beyond ordinary application packaging: a consensus bug can split money.

The project has broad package-manager presence in this batch: Homebrew, Alpine, Chocolatey, MacPorts, Nix, Arch, and openSUSE package some form of Bitcoin Core or its daemon. Official binary releases remain central, but package managers are important for operators who want reproducible installs, service integration, or policy-controlled upgrades.

The GitHub repository shows a large, active contributor base and continued releases through Bitcoin Core 31.0 in 2026. The README explicitly notes that testing and code review are the bottleneck and that the project is security-critical.

### How it is used

Operators run `bitcoind` or `bitcoin-qt` to join the peer-to-peer network, download blocks, validate consensus rules, maintain the UTXO set, relay transactions, and optionally serve wallet or RPC workflows. `bitcoin-cli` is the normal administrative interface for RPC calls.

Developers and power users use `bitcoin-tx`, `bitcoin-util`, `bitcoin-wallet`, regtest, signet, testnet, RPCs, and the documented data directory layout for testing, transaction work, wallet maintenance, and integration. The data directory contains chainstate, block files, indexes, wallets, `bitcoin.conf`, `.cookie`, and other operational files.

Packagers must care about platform support, bundled versus system libraries, database migrations, wallet formats, service files, man pages, and the difference between consensus-critical behavior and optional indexes or wallet features.

### Why package nerds care

Bitcoin Core is one of the rare packages where packaging is inseparable from protocol safety. Build flags, dependency versions, wallet database behavior, runtime paths, and upgrade order can affect node operators managing real funds and participating in a live consensus network.

It is also a package-history landmark: a small open-source peer-to-peer client became a globally significant infrastructure package with daemon, CLI, GUI, RPC surface, reproducible-release culture, security advisories, and intense review norms.

For package nerds, its file layout is unusually educational. The official filesystem document names the blocks, chainstate, indexes, wallet databases, cookie authentication, generated config, and legacy migrations, making the package a concrete map of how a decentralized network client persists state.

### Timeline

- 2008: The Bitcoin whitepaper is published.
- 2009: Satoshi Nakamoto releases the original Bitcoin client.
- 2010: The bitcoin/bitcoin GitHub repository is created as the public development tree.
- 2013: Bitcoin-Qt 0.8.0 adopts LevelDB for block and transaction indices and improves validation performance.
- 2021: Bitcoin Core 22.0 drops the leading 0.x versioning style and adds newer P2P network features such as I2P service support.
- 2026: Bitcoin Core 31.0 is published, showing continued active maintenance of the reference implementation.

### Related projects

- Bitcoin Core GUI development is split into the bitcoin-core/gui repository while the main bitcoin/bitcoin tree remains the integration tree.
- libsecp256k1 is maintained by the Bitcoin Core project for elliptic-curve cryptography used by Bitcoin.
- BIPs document protocol proposals and changes that Bitcoin Core may implement.
- Alternative Bitcoin node implementations and wallet software interoperate with the Bitcoin network but must match consensus behavior.
- LevelDB is an important storage dependency introduced for block and transaction indices in the 0.8.0 era.

### Sources

- <https://api.github.com/repos/bitcoin/bitcoin>
- <https://api.github.com/repos/bitcoin/bitcoin/releases/latest>
- <https://bitcoincore.org/en/about/>
- <https://github.com/bitcoin/bitcoin>
- <https://raw.githubusercontent.com/bitcoin/bitcoin/master/README.md>
- <https://raw.githubusercontent.com/bitcoin/bitcoin/master/doc/files.md>
- <https://raw.githubusercontent.com/bitcoin/bitcoin/master/doc/release-notes/release-notes-0.8.0.md>
- <https://raw.githubusercontent.com/bitcoin/bitcoin/master/doc/release-notes/release-notes-22.0.md>
- input.json source_facts.package-manager


## Security Notes

broad file, network, media, or database tool signal. formula declares a Homebrew service.

- **Geiger risk:** orange / medium
- broad file, network, media, or database tool signal
- formula declares a Homebrew service


## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Linux: ~/.bitcoin/bitcoin.conf
- macOS: ~/Library/Application Support/Bitcoin/bitcoin.conf
- Windows: %LOCALAPPDATA%\Bitcoin\bitcoin.conf

## Credential files

- Linux: ~/.bitcoin/.cookie
- macOS: ~/Library/Application Support/Bitcoin/.cookie
- Windows: %LOCALAPPDATA%\Bitcoin\.cookie
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** bitcoin
- **Version Scheme:** 0
- **Revision:** 1
- **Head Version:** HEAD
- **Requirements:** macos
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable

## Other Package-Manager Records

- Nix - bitcoin: normalized package name match | nixpkgs package indexes: pkgs/by-name/bi/bitcoin/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- apk - bitcoin - 30.2-r2: normalized package name match | Alpine Linux edge package indexes: bitcoin from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Decentralized P2P electronic cash system | https://www.bitcoincore.org/
- apk - bitcoin-bench - 30.2-r2: normalized package name match | Alpine Linux edge package indexes: bitcoin-bench from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Bitcoin Benchmarking Tools | https://www.bitcoincore.org/
- apk - bitcoin-cli - 30.2-r2: normalized package name match | Alpine Linux edge package indexes: bitcoin-cli from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Bitcoin CLI | https://www.bitcoincore.org/
- apk - bitcoin-doc - 30.2-r2: normalized package name match | Alpine Linux edge package indexes: bitcoin-doc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Decentralized P2P electronic cash system (documentation) | https://www.bitcoincore.org/
- apk - bitcoin-openrc - 30.2-r2: normalized package name match | Alpine Linux edge package indexes: bitcoin-openrc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Decentralized P2P electronic cash system (OpenRC init scripts) | https://www.bitcoincore.org/
- apk - bitcoin-qt - 30.2-r2: normalized package name match | Alpine Linux edge package indexes: bitcoin-qt from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Bitcoin with a Qt frontend & QR Code support | https://www.bitcoincore.org/
- apk - bitcoin-tests - 30.2-r2: normalized package name match | Alpine Linux edge package indexes: bitcoin-tests from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Bitcoin & Bitcoin-QT Unit Tests | https://www.bitcoincore.org/
- apk - bitcoin-tx - 30.2-r2: normalized package name match | Alpine Linux edge package indexes: bitcoin-tx from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Bitcoin TX (Transaction Tool) | https://www.bitcoincore.org/
- zypper - bitcoin-qt6 - 31.0-1.1: normalized package name match | openSUSE Tumbleweed package metadata: bitcoin-qt6 from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | An end-user Qt6 GUI for the Bitcoin crypto-currency | https://bitcoin.org
- zypper - bitcoin-test - 31.0-1.1: normalized package name match | openSUSE Tumbleweed package metadata: bitcoin-test from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Automated tests for bitcoin client | https://bitcoin.org
- zypper - bitcoin-utils - 31.0-1.1: normalized package name match | openSUSE Tumbleweed package metadata: bitcoin-utils from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | An end-user CLI for the Bitcoin crypto-currency | https://bitcoin.org
- zypper - bitcoind - 31.0-1.1: normalized package name match | openSUSE Tumbleweed package metadata: bitcoind from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Headless daemon for Bitcoin crypto-currency | https://bitcoin.org
- MacPorts - bitcoin: normalized package name match | MacPorts ports tree: finance/bitcoin/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1
- Chocolatey - bitcoin: normalized package name match | Chocolatey community package catalog: bitcoin from http://community.chocolatey.org/api/v2/Packages?$filter=IsLatestVersion&$select=Id&$top=1000&$skiptoken='6.9919996','gmkvextractgui'
- Nix - bitcoind: installed executable or alias match | nixpkgs package indexes: bitcoind from https://raw.githubusercontent.com/NixOS/nixpkgs/master/pkgs/top-level/all-packages.nix


## Related links

- [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Language runtime packages](https://www.automicvault.com/pkg/language-runtime-packages/) - Matched language runtime, compiler, or interpreter metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [capnp](https://www.automicvault.com/pkg/brew/capnp/) - Runtime dependency declared by Homebrew.
- [libevent](https://www.automicvault.com/pkg/brew/libevent/) - Runtime dependency declared by Homebrew.
- [zeromq](https://www.automicvault.com/pkg/brew/zeromq/) - Runtime dependency declared by Homebrew.
- [cmake](https://www.automicvault.com/pkg/brew/cmake/) - Build dependency declared by Homebrew.
- [pkgconf](https://www.automicvault.com/pkg/brew/pkgconf/) - Build dependency declared by Homebrew.
- [core-lightning](https://www.automicvault.com/pkg/brew/core-lightning/) - Popular package that depends on this formula.
- [groestlcoin](https://www.automicvault.com/pkg/brew/groestlcoin/) - Shares av.db curated category or tags: blockchain, cli, cryptocurrency, networking, wallet.
- [grin](https://www.automicvault.com/pkg/brew/grin/) - Shares av.db curated category or tags: blockchain, cli, cryptocurrency, networking.
- [grin-wallet](https://www.automicvault.com/pkg/brew/grin-wallet/) - Shares av.db curated category or tags: cli, cryptocurrency, networking, wallet.
- [btcli](https://www.automicvault.com/pkg/brew/btcli/) - Shares av.db curated category or tags: blockchain, cli, networking, wallet.
- [floresta](https://www.automicvault.com/pkg/brew/floresta/) - Shares av.db curated category or tags: bitcoin, blockchain, cli, full-node, networking.
- [hsd](https://www.automicvault.com/pkg/brew/hsd/) - Shares av.db curated category or tags: blockchain, cli, full-node, networking.
- [oasis](https://www.automicvault.com/pkg/brew/oasis/) - Shares av.db curated category or tags: blockchain, cli, networking, wallet.

## Combined YAML source

View the package source record on GitHub. [combined/bitcoin.yml](https://github.com/automic-vault/db/blob/main/combined/bitcoin.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- 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
