Start Building for Free

Upgrade server v4.x

9 months ago1 min read
Server v4.1
Server Admin
On This Page
  • Prerequisites
  • Upgrade steps

This page describes the steps needed to upgrade you CircleCI server v4.x installation.

A successful deployment will update the web app. Unless noted in the release notes, updates are rolling updates and there is no downtime.


  • Ensure you have access to the Kubernetes cluster in which server is installed.

  • Ensure you have set up Backup and Restore.

  • Ensure there is a recent backup. For more information, see the Backup and Restore guide.

Upgrade steps

  1. Check the changelog and make sure there are no actions you need to take before deploying a new version.

  2. Optionally, confirm what the update is going to do using Helm Diff:

    helm diff upgrade circleci-server oci:// -n $namespace --version <version> -f <path-to-values.yaml> --username $USERNAME --password $PASSWORD
  3. Perform the upgrade:

    helm upgrade circleci-server oci:// -n $namespace --version <version> -f <path-to-values.yaml> --username $USERNAME --password $PASSWORD
  4. Deploy and run reality check in your test environment to ensure your installation is fully operational.

Suggest an edit to this page

Make a contribution
Learn how to contribute