Skip to content

Installing the CLI

The bosh CLI is the command line tool used for interacting with all things BOSH - whether it is deployment operations or software release management.

Install

Choose your preferred installation method below to get the latest version of bosh...

Using curl

To install the bosh binary directly, choose the correct download for your system:

System Download Checksum (SHA1)
Darwin / macOS bosh-cli-3.0.1-darwin-amd64 d2fea20210a47b8c8f1f7dbb27ffb5808d47ce87
Linux bosh-cli-3.0.1-linux-amd64 ccc893bab8b219e9e4a628ed044ebca6c6de9ca0
Windows bosh-cli-3.0.1-windows-amd64.exe 41c23c90cab9dc62fa0a1275dcaf64670579ed33
  1. Download the binary (this example is using Linux):

    curl -Lo ./bosh https://s3.amazonaws.com/bosh-cli-artifacts/bosh-cli-3.0.1-linux-amd64
    
  2. Make the bosh binary executable:

    chmod +x ./bosh
    
  3. Move the binary to your PATH:

    sudo mv ./bosh /usr/local/bin/bosh
    
  4. Verify that bosh -v shows the installed version and a Succeeded message:

    $ bosh -v
    version 3.0.1-712bfd7-2018-03-13T23:26:42Z
    
    Succeeded
    

Using Homebrew on macOS

If you are on macOS with Homebrew, you can install using the Cloud Foundry tap.

  1. Use brew to install bosh-cli:

    brew install cloudfoundry/tap/bosh-cli
    
  2. Verify that bosh -v shows the installed version and a Succeeded message:

    $ bosh -v
    version 3.0.1-712bfd7-2018-03-13T23:26:42Z
    
    Succeeded
    

Additional Dependencies

When you are using bosh to bootstrap BOSH or other standalone VMs, you will need a few extra dependencies installed on your local system.

Tip

If you will not be using create-env and delete-env commands, you can skip this section.

Ubuntu Trusty

If you are running on Ubuntu Trusty, ensure the following packages are installed on your system:

sudo apt-get install -y build-essential zlibc zlib1g-dev ruby ruby-dev openssl libxslt-dev libxml2-dev libssl-dev libreadline6 libreadline6-dev libyaml-dev libsqlite3-dev sqlite3

macOS

  1. Install the Apple Command Line Tools:

    xcode-select --install
    
  2. Use Homebrew to additionally install OpenSSL:

    brew install openssl
    

CentOS

If you are running on CentOS, ensure the following packages are installed on your system:

$ sudo yum install gcc gcc-c++ ruby ruby-devel mysql-devel postgresql-devel postgresql-libs sqlite-devel libxslt-devel libxml2-devel patch openssl
$ gem install yajl-ruby

Windows

The create-env and destroy-env commands are not yet supported on Windows. Feel free to give it a try (and let us know if you have feedback), but we would recommend using a Linux-based virtual machine to run those commands instead.

Other

You should be able to use bosh on other systems... we just don't know the exact packages to recommend. In general, use these recommendations (and send us a pull request to update this page once you figure it out!):

  • compilation tools (often a build-essential-like package or "Development Tools"-like group)
  • Ruby v2.4+