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:
-
Set the
rootToRootlessUpgradeflag in thevalues.yamltotrue:rootToRootlessUpgrade: true -
Update the image.tag in the
values.yamlfile to the rootless MarkLogic version to upgrade to:repository: marklogicdb/marklogic-db tag: <11.2.0-ubi-rootless> -
Upgrade the Helm Chart using the
helm upgradecommand with the release name, chart name, and values.yaml:helm upgrade <release-name> <chart-name> -n <release-namespace> -
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 -
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 -
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
rootToRootlessUpgradeis set totrueand 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.