Get support

​

Required information

​

Tracecat version

curl -s https://<your-domain>/api/info | jq -r .version

• Docker Compose: run docker compose images api ui, or check TRACECAT__IMAGE_TAG in your .env file.
• Kubernetes: run the command below. image.tag and uiImage.tag override the chart’s appVersion, so check the running images rather than the APP VERSION column in helm list.
  kubectl get deploy -n tracecat \
    -o jsonpath='{range .items[*]}{.metadata.name}{"\t"}{.spec.template.spec.containers[0].image}{"\n"}{end}'
  
• AWS ECS Fargate: check the tracecat_image_tag Terraform variable.

​

Helm chart version

helm list -n tracecat

​

Latest release

• Docker Compose: follow Updating Tracecat.
• Kubernetes: follow Upgrade the Helm chart.
• AWS ECS Fargate: follow Updating Tracecat.

​

Details that speed up debugging

• Exact error: the full message and where it appeared (UI, workflow run event, agent chat, API response, or service log). Add a screenshot for UI issues.
• Time: when the issue happened, with timezone, so we can match it to logs.
• Reproduction steps: the smallest workflow, agent preset, or API call that reproduces the issue. Export the workflow definition as YAML and remove secrets.
• Regression: whether this worked on an earlier Tracecat version, and which one.
• Recent changes: upgrades, environment variable or Helm value changes, infrastructure, proxy, or network changes made before the issue started.
• Scope: whether the issue affects every workflow, user, and workspace, or only some.
• Service health: output of docker compose ps or kubectl get pods -n tracecat, including restart counts.
• Logs: logs from api, worker, executor, agent-worker, and agent-executor around the time of the issue. For UI issues, add errors from the browser console.
  # Docker Compose
  docker compose logs --since 1h api worker executor agent-worker agent-executor
  
  # Kubernetes
  kubectl logs -n tracecat deploy/tracecat-api --since=1h
  
• Deployment setup: your execution backend (TRACECAT__EXECUTOR_BACKEND), Temporal (bundled, self-hosted, or Temporal Cloud), PostgreSQL (bundled or external), authentication type, and whether you run behind a reverse proxy, a custom CA, or in an air-gapped environment.