Supervisor Service installation fails with "Compatibility check timed out. Please try again."

Products

• VMware vSphere Kubernetes Service

Issue/Introduction

 Error while updating VKS to 3.6.1 or higher compatibility check timed out

• WCP logs on the vCenter server /var/log/vmware/wcp/wcpsvc.log : 

2026-05-11T14:15:48.064Z debug wcp [interop/interop.go:221] [opID=69fd9c1e] CheckSupervisorSvcCompatibility for running supervisor with desired Supervisor service &{tkg.vsphere.vmware.com tkg.vsphere.vmware.com 3.6.2+v1.35      0001-01-01 00:00:00 +0000 UTC  [] [] [] [] [] {       } false}
2026-05-11T14:15:48.064Z debug wcp [precheck/constraints.go:236] [opID=69fd9c1e] Running Supervisor version: 9.0.2.0100 is fully compatible with incoming Supervisor Service tkg.vsphere.vmware.com in version 3.6.2+v1.35
2026-05-11T14:15:48.065Z debug wcp [capabilities/capabilities.go:193] [opID=69fd9c1e] Capability TKG_SupervisorService_Supported for Supervisor 'domain-cXX' is true
2026-05-11T14:15:48.065Z debug wcp [appplatform/kube_supervisor_service_version_carvel.go:1453] [opID=69fd9c1e] isEnabled: true, disabledCaps: [], err: <nil>
2026-05-11T14:15:48.080Z info wcp [appplatform/kube_supervisor_service_version_carvel.go:1498] [opID=69fd9c1e] Run upgrade hook pre-check for service tkg.vsphere.vmware.com from the installed version (3.6.0+v1.35) to the target version 
(3.6.2+v1.35)
2026-05-11T14:15:48.827Z error wcp [precheck/constraints.go:277] [opID=69fd9c1e] Response status is not OK. Status code: 500, body: error when querying svc-tkg-domain-cXX/upgrade-compatibility-service: "key vmware-system.compatibilityof
fering not found in cvmi.Status.VMwareSystemProperties on cvmi vmi-XXXXXXXXXXXXXXXXX"
. Request URL: http://localhost:1080/external-cert/http2/XXX.XXX.XXX.XXX/443/appplatform/checkupgrade?service=tkg&sourceVersion=3.6.0&targetVersion=3.6.2.
2026-05-11T14:15:48.827Z error wcp [supervisor/precheck.go:107] [opID=69fd9c1e] Compatibility check failed for the service (tkg.vsphere.vmware.com) version (3.6.2+v1.35): error when querying svc-tkg-domain-cXX/upgrade-compatibility-service: "key vmware-system.compatibilityoffering not found in cvmi.Status.VMwareSystemProperties on cvmi vmi-XXXXXXXXXXXXXXXXX"

• kubectl get cvmi -A | grep vmi-XXXXXXXXXXXXXXXXX

NAME                    DISPLAY NAME          TYPE   IMAGE VERSION     OS NAME      OS VERSION            HARDWARE VERSION
vmi-XXXXXXXXXXXXXXXXX   haproxy-v0.2.0        OVF    v0.2.0                         other3xLinux64Guest   13

Environment

vCenter Server 9.0

Cause

A non-VKS image is present in a local content-library associated with the vSphere Kubernetes releases.

Resolution

Delete this non-VKS image from  the content-library associated with the vSphere Kubernetes releases.

This issue will be resolved in a future VKS release.