# Install cargo-release with Homebrew, apk, Nix, pacman

Cargo subcommand release: everything about releasing a rust crate. Version 1.1.2 via Homebrew; verified 2026-06-22.

## Install

```sh
sudo av install brew:cargo-release
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install cargo-release
```

  Evidence: local Homebrew formula metadata

### Linux

- apk (92%):

```sh
sudo apk add cargo-release
```

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

- Nix (92%):

```sh
nix profile install nixpkgs#cargo-release
```

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

- pacman (92%):

```sh
sudo pacman -S cargo-release
```

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

## Package facts

- **Package key:** brew:cargo-release
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/cargo-release>
- **Version:** 1.1.2
- **Source summary:** Cargo subcommand release: everything about releasing a rust crate
- **Homepage:** <https://github.com/crate-ci/cargo-release>
- **Repository:** <https://github.com/crate-ci/cargo-release>
- **Upstream docs:** <https://github.com/crate-ci/cargo-release#readme>
- **License:** Apache-2.0 OR MIT
- **Source archive:** <https://github.com/crate-ci/cargo-release/archive/refs/tags/v1.1.2.tar.gz>
- **Last updated:** 2026-06-22T14:02:58-07:00
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- cargo-release (cli)
- cargo-release (alias)

## Dependencies

- libgit2

## Build dependencies

- pkgconf
- rust

## 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: 1.1.2
- Package-manager updated: 2026-06-22
- Local data: ok
- Upstream repository: https://github.com/crate-ci/cargo-release
- Upstream latest detected: v1.1.2 (current)
## Project history and usage

cargo-release is a Cargo subcommand that wraps common Rust crate release tasks such as validation, version bumps, changelog replacements, publishing, tagging, and pushing.

### Project history

The crate was first published on crates.io in March 2016, the same month the GitHub repository was created. Its README frames the tool as an extension of cargo publish with release-management defaults, while the reference documents a step-based CLI and configuration model.

### Adoption history

The tool has long-running crates.io distribution, with 146 versions reported by the crates.io API and v1.1.2 current in 2026. Batch package facts list it in Homebrew, Alpine, Nix, and Arch, indicating use outside direct cargo install workflows.

### How it is used

The default mode is a dry run: users run cargo release [level] to preview changes and add --execute to perform the release. The reference lists steps for changes, version, replace, hook, commit, publish, owner, tag, push, and config.

### Why package nerds care

It matters to Rust package maintainers because crate releases are multi-step and easy to get subtly wrong; cargo-release centralizes version policy, workspace dependency updates, publishing, and git tagging in a reproducible Cargo-native workflow.

### Timeline

- 2016: First crates.io release and GitHub repository creation.
- 2025: v0.25.x releases continued before the 1.x line.
- 2026: crates.io and GitHub releases reported v1.1.2 as current.

### Related projects

- README lists related release tools including release-pr Action, cargo-smart-release, cargo-set-version, cargo-unleash, release-plz, and cargo-workspaces.
- cargo publish and git are prerequisites or delegated tools in the documented workflow.

### Sources

- <https://api.github.com/repos/crate-ci/cargo-release>
- <https://github.com/crate-ci/cargo-release>
- <https://github.com/crate-ci/cargo-release/blob/master/docs/reference.md>
- <https://github.com/crate-ci/cargo-release#readme>
- <https://crates.io/api/v1/crates/cargo-release>
- <https://formulae.brew.sh/api/formula/cargo-release.json>


## Security Notes

narrow executable package without higher-risk signals.

- **Geiger risk:** green / low
- narrow executable package without higher-risk signals


## 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: ~/.config/cargo-release/release.toml
- macOS: ~/Library/Application Support/cargo-release/release.toml
- Unix: $CRATE/Cargo.toml ([package.metadata.release]), $CRATE/release.toml, $WORKSPACE/Cargo.toml ([workspace.metadata.release]), $WORKSPACE/release.toml, ~/.release.toml
- Windows: %FOLDERID_RoamingAppData%/cargo-release/release.toml
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** cargo-release
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **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 - cargo-release: normalized package name match | nixpkgs package indexes: pkgs/by-name/ca/cargo-release/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- apk - cargo-release - 1.1.2-r0: normalized package name match | Alpine Linux edge package indexes: cargo-release from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Everything about releasing a rust crate | https://github.com/crate-ci/cargo-release
- pacman - cargo-release - 1.1.2-1: normalized package name match | Arch Linux sync databases: cargo-release from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | Cargo subcommand "release": everything about releasing a rust crate | https://github.com/crate-ci/cargo-release


## Related links

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Package publisher tools](https://www.automicvault.com/pkg/package-publishers/) - Belongs to a package publishing or registry 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.
- [libgit2](https://www.automicvault.com/pkg/brew/libgit2/) - Runtime dependency declared by Homebrew.
- [pkgconf](https://www.automicvault.com/pkg/brew/pkgconf/) - Build dependency declared by Homebrew.
- [rust](https://www.automicvault.com/pkg/brew/rust/) - Build dependency declared by Homebrew.
- [cargo-dist](https://www.automicvault.com/pkg/brew/cargo-dist/) - Shares av.db curated category or tags: cargo, cli, developer-tools, release-automation, rust.
- [release-it](https://www.automicvault.com/pkg/brew/release-it/) - Shares av.db curated category or tags: cli, developer-tools, publishing, release-automation, versioning.
- [bump-my-version](https://www.automicvault.com/pkg/brew/bump-my-version/) - Shares av.db curated category or tags: cli, developer-tools, release-automation, versioning.
- [bumpp](https://www.automicvault.com/pkg/brew/bumpp/) - Shares av.db curated category or tags: cli, developer-tools, release-automation, versioning.
- [cargo-auditable](https://www.automicvault.com/pkg/brew/cargo-auditable/) - Shares av.db curated category or tags: cargo, cli, developer-tools, rust.
- [cargo-binstall](https://www.automicvault.com/pkg/brew/cargo-binstall/) - Shares av.db curated category or tags: cargo, cli, developer-tools, rust.
- [cargo-binutils](https://www.automicvault.com/pkg/brew/cargo-binutils/) - Shares av.db curated category or tags: cargo, cli, developer-tools, rust.
- [cargo-bloat](https://www.automicvault.com/pkg/brew/cargo-bloat/) - Shares av.db curated category or tags: cargo, cli, developer-tools, rust.
- [cargo-outdated](https://www.automicvault.com/pkg/brew/cargo-outdated/) - Both packages touch the same language runtime or ecosystem. Shared terms: cargo, cli, developer, developer-tools, libgit2.
- [cargo-c](https://www.automicvault.com/pkg/brew/cargo-c/) - Both packages touch the same language runtime or ecosystem. Shared terms: cargo, cli, developer, developer-tools, libgit2.
- [cargo-clone](https://www.automicvault.com/pkg/brew/cargo-clone/) - Both packages touch the same language runtime or ecosystem. Shared terms: cargo, cli, crate, developer, developer-tools.

## Combined YAML source

View the package source record on GitHub. [combined/cargo-release.yml](https://github.com/automic-vault/db/blob/main/combined/cargo-release.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