How to delete a Managed Master in CloudBees Jenkins Enterprise and CloudBees Core


  • A Managed Master is no longer needed or was accidentally created and needs to be deleted



When deleting a Managed Master, its storage volume may not be automatically deleted. This depends on how the cluster and the environment are configured. For example, when using Jenkins in Kubernetes, if this Jenkins argument is set -Dcom.cloudbees.masterprovisioning.kubernetes.KubernetesMasterProvisioning.deleteClaim=false and the Reclaim Policy on the Storage Class is set to Retain then the volume should still exist after the Managed Master is deleted in the web interface.

Before deleting any Managed Master, we always recommend taking a backup of the cluster just in case something goes wrong.

In order to completely delete a Managed Master, follow these steps:

First, delete the Managed Master from the CloudBees Jenkins Operations Center web interface

  1. Find the Managed Master item in the CloudBees Jenkins Operations Center


  2. Click the black arrow next to the name and select Manage


  3. Click Disconnect and then Delete on the left sidebar


Next, delete the storage volume for the Managed Master. This will require admin access for the platform you are running Jenkins on.

  • If you are running Jenkins on Kubernetes: Run the command kubectl delete persistentvolumeclaim/jenkins-home-<MASTER_NAME> (This command will differ slightly based on naming conventions)

  • If you are running Jenkins on a different platform, such as AWS or locally on your own server cluster, the process to delete the storage volume will be different. Please consult with your platform administrator on how to delete a storage volume.


Have more questions?


Please sign in to leave a comment.