Concourse for PCF v4.x

Installing Concourse

Page last updated:

Concourse for Pivotal Cloud Foundry (PCF) is a continuous integration and delivery tool that lets you build and monitor scalable pipelines seamlessly. This topic describes how to install Concourse and what you need to install it successfully.


  • A supported IaaS provider: AWS, Azure, GCP, or vSphere
  • A BOSH Director. Do not use the Ops Manager Director associated with an existing PCF deployment.
  • BOSH CLI v2
  • Concourse + Garden Run-C BOSH releases downloaded from Pivotal Network
  • The stemcell for your IaaS downloaded from Pivotal Network
  • PostgreSQL 9.5+. Concourse can be configured to connect to an external PostgreSQL database or a BOSH managed Cloud Foundry Postgres release (available on NOTE: As of Concourse 3.6.0 the Concourse BOSH release no longer supplies an internal postgres. You must provide your own postgres database as of 3.6.0

Setting Up and Installing Concourse

  1. Configure your IaaS environment by modifying your cloud config for BOSH deployment.
  2. Prepare the Concourse deployment manifest. You can write your own manifest or modify a template with your unique configuration. You can read more about BOSH deployment configurations in the concourse-bosh-deployment repo for cluster deployments

    Note: You will also need to configure authentication. Follow the instructions in Authentication.
    Provide tls_cert and tls_key values in the manifest.

  3. Prepare the cloud-config.yml file and upload it to your BOSH Director with bosh update-cloud-config.
  4. Deploy Concourse with bosh deploy. For more information, see the BOSH CLI documentation for more information. After Concourse deploys, a success message displays.

Create a pull request or raise an issue on the source for this page in GitHub