Installing Bearer CLI

Installing Bearer CLI can be done though multiple methods referenced below. To update Bearer CLI, follow the update instructions for your install method.

Installation options

Install Script

The most common way to install Bearer CLI is with the install script. It will auto-select the best build for your architecture. Defaults installation to ./bin and to the latest release version:

curl -sfL | sh

The default installation script works well for most use cases, but if you need more control you can customize the options by passing additional parameters.

  • -b: sets the installation directory (defaults to ./bin)
  • -d: enables debug logging
  • [tag]: specifies a tag release (defaults to the latest release)
curl -sfL | sh -s -- -b /usr/local/bin

Note; Bearer requires git (2.34+) to be available on your $PATH. For MacOS we only support 12+ (Monterey) and later. Where these dependencies cannot be met we recommend using Docker.


Using Bearer CLI's official Homebrew tap:

brew install bearer/tap/bearer


sudo apt-get update && sudo apt-get install ca-certificates -y && sudo update-ca-certificates
sudo apt-get install apt-transport-https
echo "deb [trusted=yes] /" | sudo tee -a /etc/apt/sources.list.d/fury.list
sudo apt-get update
sudo apt-get install bearer


Add repository setting:

$ sudo vim /etc/yum.repos.d/fury.repo
name=Gemfury Private Repo

Then install with yum:

sudo yum -y update
sudo yum -y install bearer


Bearer CLI is also available as a Docker image on Docker Hub and

With docker installed, you can run the following command with the appropriate paths in place of the examples.

docker run --rm -v /path/to/repo:/tmp/scan bearer/bearer:latest-amd64 scan /tmp/scan

Additionally, you can use docker compose. Add the following to your docker-compose.yml file and replace the volumes with the appropriate paths for your project:

version: "3"
platform: linux/amd64
image: bearer/bearer:latest-amd64
- /path/to/repo:/tmp/scan

Then, run the docker compose run command to run Bearer CLI with any specified flags:

docker compose run bearer scan /tmp/scan --debug


Download the archive file for your operating system/architecture from the release page.

Unpack the archive, and put the binary somewhere in your $PATH (on UNIX-y systems, /usr/local/bin or the like). Make sure it has permission to execute. Note; Bearer requires git to be available on your $PATH also.

Updating Bearer CLI

Updating Bearer CLI provides you with the latest fixes and features. You can see an overview of the latest release on the releases page.

Install Script

To update to the latest version with the install script, run the install command again to override the existing installation.

curl -sfL | sh


Update brew and upgrade Bearer CLI

brew update && brew upgrade bearer/tap/bearer


sudo apt-get update
sudo apt-get install bearer


sudo yum -y update bearer


The Docker configurations above uses the latest release, but you may need to tell Docker to explicitly retrieve the latest image:

docker image pull bearer/bearer:latest-amd64


To update Bearer CLI when using the binary, download the latest release and overwrite your existing installation location.