Note: Applies to CLI v2.

(See What is a Stemcell? for an introduction to stemcells.)

As described earlier, each resource pool references a specific stemcell on the Director. Before the Director can form a deployment, all referenced stemcells must be uploaded to the Director.

Finding Stemcells

The stemcells section of lists official stemcells.

Uploading to the Director

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

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

    $ bosh upload-stemcell URL --sha1 SHA1
  • If you have a stemcell tarball on your local machine:

    $ bosh upload-stemcell ~/Downloads/bosh-stemcell-3421.4-warden-boshlite-ubuntu-trusty-go_agent.tgz

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

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

Name                                         Version  OS             CPI  CID
bosh-warden-boshlite-ubuntu-trusty-go_agent  3421.4*  ubuntu-trusty  -    6c9c002e-bb46-4838-4b73-ff1afaa0aa21

(*) Currently deployed

1 stemcells


Deployment Manifest Usage

To use uploaded stemcell in your deployment, add stemcells:

- alias: default
  os: ubuntu-trusty
  version: 3421.4

Next: Uploading Releases

Previous: Deployment Basics

Contribute changes to this page