Updating your Server Installation

To update your CircleCI Enterprise or server you can follow the below steps. Please allow yourself 15-20 minutes to go through this process.

CircleCI Server 4.x

1. Before upgrading, please create a Backup and Restore point.
2. You can then follow the steps outlined in our docs to guide you through the upgrade.

$ NAMESPACE=<namespace>
$ USERNAME=<USERNAME>
$ PASSWORD=<PASSWORD>
$ helm diff upgrade circleci-server oci://cciserver.azurecr.io/circleci-server -n $NAMESPACE --version<version> -f <path-to-values.yaml> --username $USERNAME --password $PASSWORD

$ namespace=<namespace>
$ USERNAME=<USERNAME>
$ PASSWORD=<PASSWORD>
$ helm upgrade circleci-server oci://cciserver.azurecr.io/circleci-server -n $NAMESPACE --version <version> -f <path-to-values.yaml> --username $USERNAME --password $PASSWORD

To get the <version>, you can consult our changelog.

CircleCI Server 3.x

1. Before upgrading, please create a Backup and Restore point.
2. Once a backup has been created, you can follow the instructions found in our docs via the KOTS Admin Console.

Additional Notes:

• Before updating check the server changelog.
• Create a backup of your installation.
• Make sure no jobs are running.

If you encounter any difficulties or have any further questions, please submit a ticket to CircleCI Support.

Additional Resources:

• Server 4.x Upgrade Path
• [Server 4.x] How do I confirm what is deployed during a Server version upgrade?
• [Server] Helm login results in unauthorized: authentication required error