Note: Applies to CLI v2.

(See What is a Release? for an introduction to releases.)

As described earlier, each deployment references one or many releases on the Director. Before the Director can form a deployment, all referenced releases must be uploaded to the Director.

Finding Releases

Releases are distributed in two ways: as a release tarball or through a source code repository. The releases section of provides a good list of available releases and their tarballs.

Here are a few popular releases:

Uploading to the Director

Assuming that the CLI is already targeted at the Director, the CLI provides a single command to upload a release.

  • If you have a URL to a release tarball (for example a URL provided by

    $ bosh upload-release

    Alternatively, if you have a release tarball on your local machine:

    $ bosh upload-release ~/Downloads/zookeeper-0.0.5.tgz
  • If you cloned a Git repository:

    Note that all release repositories have a releases/ folder that contains release YAML files. These files have all the required information about how to assemble a specific version of a release (provided that the release maintainers produce and commit that version to the repository). You can use the YAML files to either directly upload a release, or to create a release tarball locally and then upload it.

    $ cd ~/workspace/zookeeper-release
    $ bosh upload-release

    Alternatively, to build a release tarball locally from a release YAML file:

    $ cd ~/workspace/zookeeper-release
    $ bosh create-release releases/zookeeper/zookeeper-12.yml --tarball x.tgz
    $ bosh upload-release x.tgz

Once the command succeeds, you can view all uploaded releases in the Director:

$ bosh -e vbox releases
Using environment '' as client 'admin'

Name       Version            Commit Hash
dns        0+dev.1496791266*  65f3b30+
zookeeper  0.0.5*             b434447

(*) Currently deployed
(+) Uncommitted changes

3 releases


Deployment Manifest Usage

To use an uploaded release in your deployment, update the releases section in your deployment manifest:

- name: zookeeper
  version: 0.0.5

Next: Deploying

Previous: Uploading Stemcells

Contribute changes to this page