Powered by Zoomin Software. For more details please contactZoomin

MarkLogic® Server on Kubernetes

Upgrading the MarkLogic root image to rootless

Upgrading the MarkLogic root image to rootless

  • Last Updated: April 14, 2026
  • 1 minute read
    • MarkLogic Server
    • Documentation

To upgrade the MarkLogic image from root to rootless:

  1. Set the rootToRootlessUpgrade flag in the values.yaml to true:

    rootToRootlessUpgrade: true
    
  2. Update the image.tag in the values.yaml file to the rootless MarkLogic version to upgrade to:

    repository: marklogicdb/marklogic-db
    tag: <11.2.0-ubi-rootless>
    
  3. Upgrade the Helm Chart using the helm upgrade command with the release name, chart name, and values.yaml:

    helm upgrade <release-name> <chart-name>  -n <release-namespace>
    
  4. Use this command to start the upgrade. The command will delete the pod with the smallest ordinal that is a MarkLogic bootstrap host:

    kubectl delete pod <pod-name> -n <release-namespace>
    

    For example:

    kubectl delete pod dnode-group-marklogic-0
    
  5. Once the pod is terminated, a new pod is created with a rootless MarkLogic version. Monitor the pod status with this command:

    kubectl get pods --nampespace=<your-namespace> -w
    
  6. As soon as all pods are back running, verify the upgrade by checking the permissions on volume mounts or by running the required tests.

    Note:

    If rootToRootlessUpgrade is set to true and the image tag is not rootless, then this error message is displayed:

    ERROR: Root to Rootless Upgrade is supported only if rootToRootlessUpgrade flag is true and image type is rootless.

TitleResults for “How to create a CRG?”Also Available inAlert