Switch branches/tags
Nothing to show
Find file
Fetching contributors…
Cannot retrieve contributors at this time
63 lines (38 sloc) 3.09 KB

Cloud Foundry OSS Resources

Cloud Foundry Open Source Platform as a Service

  • [Learn][learn]
  • [Ask Questions][Ask Questions]
  • [File a Bug][File a Bug]
  • [OSS Contributions][OSS Contributions]


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: