# Install bitrise with Homebrew, Nix

Command-line automation tool. Version 2.41.0 via Homebrew; verified 2026-07-02.

## Install

```sh
sudo av install brew:bitrise
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install bitrise
```

  Evidence: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#bitrise
```

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

## Package facts

- **Package key:** brew:bitrise
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/bitrise>
- **Version:** 2.41.0
- **Source summary:** Command-line automation tool
- **Homepage:** <https://github.com/bitrise-io/bitrise>
- **Repository:** <https://github.com/bitrise-io/bitrise>
- **Upstream docs:** <https://docs.bitrise.io/en/bitrise-ci/bitrise-cli/managing-secrets-locally>
- **License:** MIT
- **Source archive:** <https://github.com/bitrise-io/bitrise/archive/refs/tags/v2.41.0.tar.gz>
- **Last updated:** 2026-07-02T09:38:39Z
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- bitrise (cli)
- bitrise (alias)

## Build dependencies

- go

## Uses from macOS

- rsync

## 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: 2.41.0
- Package-manager updated: 2026-07-02
- Local data: ok
- Upstream repository: https://github.com/bitrise-io/bitrise
- Upstream latest detected: v2.41.0 (current)
## Project history and usage

Bitrise CLI is the open source workflow runner behind Bitrise builds. The README describes it as the component that executes steps defined in bitrise.yml on Bitrise build machines and as a standalone tool for validating and running workflows locally.

For package users, the CLI matters because it turns a hosted mobile CI product into a reproducible local command: brew install bitrise, run bitrise validate or bitrise run, and debug the same YAML-driven workflow before pushing.

### Project history

The public repository was created in 2015 and has long used Go as a portable implementation language for local automation on macOS and Linux. Its tag history starts before 1.0 and continues through the v2 series, with v2.40.7 published in June 2026.

Bitrise's own docs frame the CLI around bitrise.yml: users can download a project's configuration from bitrise.io or create a bitrise.yml in the project root, then run a named workflow locally.

### Adoption history

Homebrew and Nix package entries in the input show adoption as a Unix developer tool rather than only a downloadable vendor binary. The README also points to Homebrew, Nix, GitHub releases, and community maintained packages.

The CLI's adoption is tied to Bitrise's mobile CI ecosystem: it lets teams validate CI changes without waiting for a remote build and gives local access to the same workflow primitives used by hosted Bitrise.

### How it is used

Common package-manager usage is to install the bitrise executable, keep bitrise.yml in the project root, run bitrise validate while editing the file, and run bitrise run workflow_name for local CI workflow execution.

Secrets are intentionally split from the normal build config. Bitrise documents local secret handling with .bitrise.secrets.yml, which is package-nerd-important because it keeps the checked-in YAML portable while leaving local credentials outside the main workflow file.

### Why package nerds care

Bitrise CLI is a good example of a hosted CI service exposing its runner as a packageable local binary. That makes the package more than a vendor helper: it is the executable contract for a CI configuration format.

It also sits in the mobile-devops corner of package-manager culture, where macOS availability matters because iOS builds and signing workflows often start on developer Macs before being reproduced in CI.

### Timeline

- 2015: bitrise-io/bitrise repository created.
- 2016: Early 0.9.x and 1.x tags appear in the public tag history.
- 2020s: README documents Homebrew and Nix installation paths alongside GitHub release downloads.
- 2026: v2.40.7 release published on GitHub.

### Related projects

- Bitrise CI is the hosted service whose builds are executed by the CLI runner.
- bitrise-io/bitrise-steplib is the default step library source referenced by Bitrise configuration examples.
- Bitrise workflow recipes and sample apps provide reusable examples around bitrise.yml workflows.

### Sources

- <https://docs.bitrise.io/en/bitrise-ci/bitrise-cli/managing-secrets-locally>
- <https://docs.bitrise.io/en/bitrise-ci/bitrise-cli/running-your-first-local-build-with-the-cli>
- <https://github.com/bitrise-io/bitrise#readme>
- source_facts.package-manager


## Security Notes

No matching local secret-handling manifest was found for bitrise. Nucleus package metadata is still published here so future coverage has a stable package URL.



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

- Unix: bitrise.yml

## Credential files

- Unix: .bitrise.secrets.yml
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** bitrise
- **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 - bitrise: normalized package name match | nixpkgs package indexes: pkgs/by-name/bi/bitrise/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1


## 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.
- [dagger](https://www.automicvault.com/pkg/brew/dagger/) - Shares av.db curated category or tags: automation, ci-cd, cli, developer-tools.
- [gitea-runner](https://www.automicvault.com/pkg/brew/gitea-runner/) - Shares av.db curated category or tags: automation, ci-cd, cli, developer-tools.
- [jenkins-job-builder](https://www.automicvault.com/pkg/brew/jenkins-job-builder/) - Shares av.db curated category or tags: automation, ci-cd, cli, developer-tools.
- [pipelight](https://www.automicvault.com/pkg/brew/pipelight/) - Shares av.db curated category or tags: automation, ci-cd, cli, developer-tools.
- [tfcmt](https://www.automicvault.com/pkg/brew/tfcmt/) - Shares av.db curated category or tags: automation, ci-cd, cli, developer-tools.
- [act](https://www.automicvault.com/pkg/brew/act/) - Shares av.db curated category or tags: ci-cd, cli, developer-tools.
- [ahoy](https://www.automicvault.com/pkg/brew/ahoy/) - Shares av.db curated category or tags: automation, cli, developer-tools.
- [all-repos](https://www.automicvault.com/pkg/brew/all-repos/) - Shares av.db curated category or tags: automation, cli, developer-tools.
- [atomist-cli](https://www.automicvault.com/pkg/brew/atomist-cli/) - Local package facts share a topical domain. Shared terms: automation, cli, command-line, developer, developer-tools.
- [clitest](https://www.automicvault.com/pkg/brew/clitest/) - Local package facts share a topical domain. Shared terms: automation, cli, command-line, developer, developer-tools.

## Combined YAML source

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