Troubleshooting

Last updated: May 29, 2026

Accessing the logs

To access the logs, run the following commands:

kubectl logs service/xt-web --all-containers=true
kubectl logs -l app=xt-excel-parser
kubectl logs -l app=xt-runner
kubectl logs -l app=xt-differ-sequencematch
kubectl logs -l app=xt-differ-rowcolalign

To limit the amount of logs, add --tail. For example, to limit to the most recent 20 lines:

kubectl logs --tail=20 -l app=xt-excel-parser

To live tail/stream the logs, use the -f argument, for example:

kubectl logs -f -l app=xt-excel-parser

Our support can indicate which logs are of primary concern depending on the issue you’re seeing.

Debugging ingress issues

If you can’t access xltrail, try to access xltrail directly via port-forwarding (you’ll need to do this from a local Terminal, not a cloud shell):

kubectl port-forward svc/xt-frontend 8080:80 -n xltrail

This should print the following:

Forwarding from 127.0.0.1:8080 -> 80
Forwarding from [::1]:8080 -> 80

Then go to http://127.0.0.1:8080  in your browser and see if the xltrail login screen appears. If it does, you either have a misconfiguration in your ingress-nginx, cert-manager or in the ingress configuration of your xltrail Helm chart.

Useful Kubernetes Commands

Show installed xltrail version

$ helm list --namespace xltrail
NAME   	NAMESPACE	REVISION	UPDATED                              	STATUS  	CHART         	APP VERSION
xltrail	xltrail  	7       	2025-01-15 10:30:12.191718 +0100 CET 	deployed	xltrail-1.0.42	4.3.5487

Make sure to replace xltrail with the name of the namespace where xltrail is installed.

Show available xltrail versions

$ helm search repo xltrail/xltrail --versions
NAME           	CHART VERSION	APP VERSION	DESCRIPTION
xltrail/xltrail	1.0.42       	4.3.5487   	A version control system for Excel files
xltrail/xltrail	1.0.41       	4.3.5166   	A version control system for Excel files
xltrail/xltrail	1.0.40       	4.3.4811   	A version control system for Excel files
...

Install a specific version of xltrail

$ helm upgrade --install xltrail xltrail/xltrail --version 1.0.42

Include all the arguments from your original installation such as -f myvalues.yaml. Note that the version refers to the Chart version, not the app version!