Note: See [CLI v2](cli-v2.html) for an updated CLI.

bosh-init is used for creating and updating a Director VM (and its persistent disk) in an environment.

Here are the latest binaries:


  1. Download the binary for your platform and place it on your PATH. For example on UNIX machines:

    $ chmod +x ~/Downloads/bosh-init-*
    $ sudo mv ~/Downloads/bosh-init-* /usr/local/bin/bosh-init
  2. Check bosh-init version to make sure it is properly installed:

    $ bosh-init -v
  3. Depending on your platform install following packages:

    Ubuntu Trusty

    $ 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


    $ 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

    Mac OS X

    Install Apple Command Line Tools:

    $ xcode-select --install

    Use Homebrew to install OpenSSL:

    $ brew install openssl

  4. Make sure Ruby 2+ is installed:

    $ ruby -v
    ruby 2.2.3p173 (2015-08-18 revision 51636) [x86_64-darwin14]

See Using bosh-init for details on how to use it.

Contribute changes to this page