Skip to content
This repository


tree: 9275efc422

Fetching latest commit…

Cannot retrieve the latest commit at this time


Cloud Foundry BOSH is an open source tool chain for release engineering, deployment and lifecycle management of large scale distributed services. In this manual we describe the architecture, topology, configuration, and use of BOSH, as well as the structure and conventions used in packaging and deployment.

Cloud Foundry OSS Resources

Cloud Foundry Open Source Platform as a Service


There is a Cloud Foundry documentation set for open source developers, and one for users:

To make changes to our documentation, follow the [OSS Contribution][oss] steps and contribute to the oss-docs repository.

Ask Questions

Questions about the Cloud Foundry Open Source Project can be directed to our Google Groups.

BOSH Developers: BOSH Users: VCAP (Cloud Foundry) Developers:

Questions about can be directed to:

File a Bug

To file a bug against Cloud Foundry Open Source and its components, sign up and use our bug tracking system:

OSS Contributions

The Cloud Foundry team uses Gerrit, a code review tool that originated in the Android Open Source Project. We also use GitHub as an official mirror, though all pull requests are accepted via Gerrit.

Follow these steps to make a contribution to any of our open source repositories:

  1. Complete our CLA Agreement for individuials or corporations
  2. Sign up for an account on our public Gerrit server at
  3. Create and upload your public SSH key in your Gerrit account profile
  4. Set your name and email

    git config --global "Firstname Lastname"
    git config --global ""

Install our gerrit-cli gem:

    gem install gerrit-cli

Clone the Cloud Foundry repo

Note: to clone the BOSH repo, or the Documentation repo, replace vcap with bosh or oss-docs

    gerrit clone ssh://
    cd vcap

Make your changes, commit, and push to gerrit:

    git commit
    gerrit push

Once your commits are approved by our Continuous Integration Bot (CI Bot) as well as our engineering staff, return to the Gerrit interface and MERGE your changes. The merge will be replicated to GitHub automatically at If you get feedback on your submission, we recommend squashing your commit with the original change-id. See the squashing section here for more details:

Something went wrong with that request. Please try again.