# Install bosh-cli with Homebrew, Nix

Cloud Foundry BOSH CLI v2. Version 7.10.6 via Homebrew; verified 2026-06-18.

## Install

```sh
sudo av install brew:bosh-cli
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install bosh-cli
```

  Evidence: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#bosh-cli
```

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

## Package facts

- **Package key:** brew:bosh-cli
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/bosh-cli>
- **Version:** 7.10.6
- **Source summary:** Cloud Foundry BOSH CLI v2
- **Homepage:** <https://bosh.io/docs/cli-v2/>
- **Repository:** <https://github.com/cloudfoundry/bosh-cli>
- **Upstream docs:** <https://bosh.io/docs>
- **License:** Apache-2.0
- **Source archive:** <https://github.com/cloudfoundry/bosh-cli/archive/refs/tags/v7.10.6.tar.gz>
- **Last updated:** 2026-06-18T07:59:33Z
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- bosh-cli (cli)
- bosh-cli (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: 7.10.6
- Package-manager updated: 2026-06-18
- Local data: ok
- Upstream repository: https://github.com/cloudfoundry/bosh-cli
- Upstream latest detected: v7.10.6 (current)
## Project history and usage

BOSH CLI is the command-line interface for Cloud Foundry BOSH, the release engineering, deployment, and lifecycle-management system used to operate large distributed software across clouds.

### Project history

BOSH began as Cloud Foundry infrastructure tooling, combining release packaging, stemcells, deployment manifests, VM lifecycle management, monitoring, recovery, and rolling updates. The BOSH site presents it as a project for managing both small and large-scale cloud software.

The Homebrew package is specifically the Go-based BOSH CLI v2 line. Its repository was created in 2016, and BOSH documentation distinguishes it from the older Ruby-based CLI v1, noting that v2 is stateless and uses hyphenated single commands.

### Adoption history

BOSH CLI adoption follows BOSH itself: Cloud Foundry operators use it to deploy directors, upload releases and stemcells, inspect deployments, run errands, and apply manifest changes. Cloud Foundry deployment documentation explicitly says Cloud Foundry leverages BOSH for deployment, lifecycle management, and distributed-systems monitoring.

The batch input records Homebrew and Nix packaging, reflecting its role as an operator workstation tool rather than an end-user application.

### How it is used

Operators use the CLI to target BOSH environments, log in, interpolate variables, upload releases and stemcells, deploy manifests, inspect VMs, run tasks, and manage BOSH releases. The CLI docs are organized around those operational commands.

The CLI stores its local configuration under ~/.bosh/config, but v2 expects more state to be supplied explicitly through environments, aliases, flags, and manifest files compared with the old Ruby CLI workflow.

### Why package nerds care

BOSH CLI is significant because it is one of the classic Cloud Foundry operator tools: small as a package, but connected to a deep ecosystem of releases, stemcells, directors, CPIs, and cloud deployments.

The v1-to-v2 transition is package-history relevant because it moved the operator CLI from a Ruby gem era to a Go binary era, changing installation and packaging expectations.

### Timeline

- 2016-08: Official GitHub repository metadata shows cloudfoundry/bosh-cli created.
- 2018: GitHub release metadata shows v5.0.1 in the public release feed.
- 2026: Repository metadata and package-manager input show ongoing maintenance and Homebrew/Nix distribution.

### Related projects

- cloudfoundry/bosh is the wider BOSH release and director project that the CLI operates.
- bosh-deployment provides manifests and operations files for deploying BOSH directors.
- Cloud Foundry cf-deployment is a major downstream deployment workflow that relies on BOSH.

### Sources

- <https://api.github.com/repos/cloudfoundry/bosh-cli>
- <https://bosh.io/>
- <https://bosh.io/docs/cli-v2-diff/>
- <https://bosh.io/docs/cli-v2-install/>
- <https://bosh.io/docs/cli-v2/>
- <https://docs.cloudfoundry.org/deploying/index.html>
- <https://github.com/cloudfoundry/bosh-cli>
- source_facts.package-manager


## Security Notes

infrastructure mutation or orchestration signal.

- **Geiger risk:** orange / medium
- infrastructure mutation or orchestration signal


## 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: ~/.bosh/config
## Source Database Details

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


## Related links

- [Cloud CLI packages](https://www.automicvault.com/pkg/cloud-clis/) - Belongs to a cloud or infrastructure command family.
- [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.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew.
- [aws-elasticbeanstalk](https://www.automicvault.com/pkg/brew/aws-elasticbeanstalk/) - Shares av.db curated category or tags: cli, cloud-infrastructure, deployment.
- [ecs-deploy](https://www.automicvault.com/pkg/brew/ecs-deploy/) - Shares av.db curated category or tags: cli, cloud-infrastructure, deployment.
- [helmfile](https://www.automicvault.com/pkg/brew/helmfile/) - Shares av.db curated category or tags: cli, cloud-infrastructure, deployment.
- [helmsman](https://www.automicvault.com/pkg/brew/helmsman/) - Shares av.db curated category or tags: cli, cloud-infrastructure, deployment.
- [krane](https://www.automicvault.com/pkg/brew/krane/) - Shares av.db curated category or tags: cli, cloud-infrastructure, deployment.
- [nelm](https://www.automicvault.com/pkg/brew/nelm/) - Shares av.db curated category or tags: cli, cloud-infrastructure, deployment.
- [railway](https://www.automicvault.com/pkg/brew/railway/) - Shares av.db curated category or tags: cli, cloud-infrastructure, deployment.
- [sail](https://www.automicvault.com/pkg/brew/sail/) - Shares av.db curated category or tags: cli, cloud-infrastructure, deployment.
- [mbt](https://www.automicvault.com/pkg/brew/mbt/) - Local package facts share a topical domain. Shared terms: cli, cloud, cloud-foundry, cloud-infrastructure, deployment.

## Combined YAML source

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