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


Each stemcell is uniquely identified by its name and version.

You can identify stemcell version from inside the VM via following files:

  • /var/vcap/bosh/etc/stemcell_version: Example: 3232.1
  • /var/vcap/bosh/etc/stemcell_git_sha1: Example: 8c8a6bd2ac5cacb11c421a97e90b888be9612ecb+

Note: Release authors should not use the contents of these files in their releases.

See Stemcell Building to find stemcell archive structure.

Fixing corrupted stemcells

Occasionally stemcells are deleted from the IaaS outside of the Director. For example your vSphere administrator decided to clean up your vSphere VMs folder. The Director of course will continue to reference deleted IaaS asset and CPI will eventually raise an error when trying to create new VM. bosh upload stemcell command provides a --fix flag which allows to reupload stemcell with the same name and version into the Director fixing this problem.

Cleaning up uploaded stemcells

Over time the Director accumulates stemcells. Stemcells could be deleted manually via bosh delete stemcell command or be cleaned up via bosh cleanup command.

Contribute changes to this page