OpenShift

Last updated: May 29, 2026

Upgrade instructions for OpenShift-based installations. OpenShift support was introduced in version 4.1.6. See Release Notes for the full changelog.

Upgrade Paths

Click a version to expand upgrade instructions. Orange rows are migration boundaries. All upgrades require helm uninstall before helm upgrade --install because StatefulSets cannot be updated in-place. PVCs/PVs are preserved. Use values.openshift.yaml for arbitrary UID compatibility.

5.0.0 latest May 28, 2026


helm repo add xltrail https://xltrail.com/charts
helm repo update
helm show values xltrail/xltrail > values.openshift.yaml
# Merge your settings into values.openshift.yaml
 
oc config set-context --current --namespace=xltrail
helm uninstall xltrail
oc get pods  # wait until no pods remain
 
helm upgrade --install xltrail xltrail/xltrail -f values.openshift.yaml --version 5.0.0
oc get pods  # verify all pods are running

4.3.5166-384943f December 11, 2025


helm repo add xltrail https://xltrail.com/charts
helm repo update
helm show values xltrail/xltrail > values.openshift.yaml
# Merge your settings into values.openshift.yaml
 
oc config set-context --current --namespace=xltrail
helm uninstall xltrail
oc get pods  # wait until no pods remain
 
helm upgrade --install xltrail xltrail/xltrail -f values.openshift.yaml --version 4.3.5166-384943f
oc get pods  # verify all pods are running

⚠️ PVC migration — MinIO backup/restore required

Version 4.3.4811 introduces a new PVC xt-git-repositories which replaces the old xt-source-xltrail-volume-xt-git-web-0. Migration uses MinIO as temporary storage.

1. Snapshot the PVC xt-source-xltrail-volume-xt-git-web-0 for backup. Ensure the MinIO PVC has enough space:


oc exec xt-git-web-0 -c git -n xltrail -- df -h /source/repositories
oc exec xt-minio-0 -n xltrail -- df -h /data

2. Uninstall, then run in backup mode (copies repos from old PVC to MinIO):


helm uninstall xltrail
oc get pods  # wait until no pods remain
 
helm upgrade --install xltrail xltrail/xltrail -f values.openshift.yaml --version <target> \
  --set maintenanceMode=true --set backupRepositories=true
oc logs -f xt-git-web-0 -c ops  # wait until Running

3. Run in restore mode (copies repos from MinIO to new PVC):


helm upgrade --install xltrail xltrail/xltrail -f values.openshift.yaml --version <target> \
  --set maintenanceMode=true --set restoreRepositories=true
oc logs -f xt-app-0 -c ops  # wait until Running

4. Start normally:


helm upgrade --install xltrail xltrail/xltrail -f values.openshift.yaml --version <target>

5. Verify everything works, then delete the old PVC:


oc delete pvc xt-source-xltrail-volume-xt-git-web-0

4.3.4811-3f509cc July 4, 2025


helm repo add xltrail https://xltrail.com/charts
helm repo update
helm show values xltrail/xltrail > values.openshift.yaml
# Merge your settings into values.openshift.yaml
 
oc config set-context --current --namespace=xltrail
helm uninstall xltrail
oc get pods  # wait until no pods remain
 
helm upgrade --install xltrail xltrail/xltrail -f values.openshift.yaml --version 4.3.4811-3f509cc
oc get pods  # verify all pods are running

⚠️ StatefulSet migration — xt-git-web → xt-app

Version 4.2.4548 renamed the StatefulSet from xt-git-web to xt-app. This requires a manual backup and restore of git repositories via MinIO.

1. Backup repositories from xt-git-web-0:


oc exec xt-git-web-0 -c git -n xltrail -- \
  mc cp --recursive /source/repositories/ minio/xltrail-repositories/

2. Uninstall and deploy the new version (creates xt-app StatefulSet):


helm uninstall xltrail
oc get pods  # wait until no pods remain
 
helm upgrade --install xltrail xltrail/xltrail -f values.openshift.yaml --version 4.2.4548

3. Restore repositories to xt-app-0:


oc exec xt-app-0 -c git -n xltrail -- \
  mc cp --recursive minio/xltrail-repositories/ /source/repositories/

4. Verify: oc get pods — everything should be up and running.

4.2.4548 April 28, 2025


helm repo add xltrail https://xltrail.com/charts
helm repo update
helm show values xltrail/xltrail > values.openshift.yaml
# Merge your settings into values.openshift.yaml
 
oc config set-context --current --namespace=xltrail
helm uninstall xltrail
oc get pods  # wait until no pods remain
 
helm upgrade --install xltrail xltrail/xltrail -f values.openshift.yaml --version 4.2.4548
oc get pods  # verify all pods are running

4.1.12 March 18, 2025


helm repo add xltrail https://xltrail.com/charts
helm repo update
helm show values xltrail/xltrail > values.openshift.yaml
# Merge your settings into values.openshift.yaml
 
oc config set-context --current --namespace=xltrail
helm uninstall xltrail
oc get pods  # wait until no pods remain
 
helm upgrade --install xltrail xltrail/xltrail -f values.openshift.yaml --version 4.1.12
oc get pods  # verify all pods are running

4.1.11 March 9, 2025


helm repo add xltrail https://xltrail.com/charts
helm repo update
helm show values xltrail/xltrail > values.openshift.yaml
# Merge your settings into values.openshift.yaml
 
oc config set-context --current --namespace=xltrail
helm uninstall xltrail
oc get pods  # wait until no pods remain
 
helm upgrade --install xltrail xltrail/xltrail -f values.openshift.yaml --version 4.1.11
oc get pods  # verify all pods are running

4.1.10 February 13, 2025


helm repo add xltrail https://xltrail.com/charts
helm repo update
helm show values xltrail/xltrail > values.openshift.yaml
# Merge your settings into values.openshift.yaml
 
oc config set-context --current --namespace=xltrail
helm uninstall xltrail
oc get pods  # wait until no pods remain
 
helm upgrade --install xltrail xltrail/xltrail -f values.openshift.yaml --version 4.1.10
oc get pods  # verify all pods are running

4.1.8 January 31, 2025


helm repo add xltrail https://xltrail.com/charts
helm repo update
helm show values xltrail/xltrail > values.openshift.yaml
# Merge your settings into values.openshift.yaml
 
oc config set-context --current --namespace=xltrail
helm uninstall xltrail
oc get pods  # wait until no pods remain
 
helm upgrade --install xltrail xltrail/xltrail -f values.openshift.yaml --version 4.1.8
oc get pods  # verify all pods are running

4.1.7 October 30, 2024


helm repo add xltrail https://xltrail.com/charts
helm repo update
helm show values xltrail/xltrail > values.openshift.yaml
# Merge your settings into values.openshift.yaml
 
oc config set-context --current --namespace=xltrail
helm uninstall xltrail
oc get pods  # wait until no pods remain
 
helm upgrade --install xltrail xltrail/xltrail -f values.openshift.yaml --version 4.1.7
oc get pods  # verify all pods are running

4.1.6 October 9, 2024

First version with OpenShift support. Containers run as non-root user (UID 1001), compatible with OpenShift’s arbitrary UID requirement.


helm repo add xltrail https://xltrail.com/charts
helm repo update
helm show values xltrail/xltrail > values.openshift.yaml
# Merge your settings into values.openshift.yaml
 
oc config set-context --current --namespace=xltrail
helm uninstall xltrail
oc get pods  # wait until no pods remain
 
helm upgrade --install xltrail xltrail/xltrail -f values.openshift.yaml --version 4.1.6
oc get pods  # verify all pods are running