This guide provides a high-level overview of upgrading a Concourse deployment using BOSH, including command requirements and common errors.

Here you will learn how to upgrade from v5.5.x to v6.3.x. If you are using a previous release of Concourse for VMware Tanzu, see the previous upgrade guides to first migrate to v5.5.x before you continue.

Notes about breaking changes and other information can be found in the release notes.


This procedure upgradess Concourse through BOSH, using the BOSH CLI v2 command bosh deploy.

The BOSH CLI must be installed before following the rest of this guide. For steps to install the BOSH CLI, see the BOSH documentation.

Important Before you begin, you must only backup or upgrade a working Concourse deployment. Before upgrading, fix any issues in your Concourse deployment. This is necessary to ensure your backup files are valid, and to prevent problems occurring during the upgrade procedure.
For more information, see Checking the health and status of your deployments.

VMware recommends these three steps for upgrading:

  1. Backup with BBR
  2. Upgrade Concourse with BOSH
  3. Validate your new deployment


When you are ready to begin, follow the steps in Back up Concourse with BBR.

Note If you are using Helm instead of BOSH, see Upgrading Concourse with Helm.

check-circle-line exclamation-circle-line close-line
Scroll to top icon