To ensure the readiness of your environment or do pre-upgrade validation, we provide preflight checks. The Preflight checks levarage Troubleshoot, a Kubernetes plugin for cluster diagnostics. No data will be exported during the process.
The following how-to guide explains how to run the preflight checks.
Install the Plugin
Or refer to the Troubleshoot documentation for other installation options.
Copy the Preflight Helm Chart
Add the preflight chart to your ECR copy step:
Run the Checks
Use helm template to render the preflight spec, then pipe it to kubectl preflight:
This validates node labels, StorageClass configuration, and other requirements. It also checks upgrade readiness of an existing ClickHouse cluster and reports deprecated feature flags or new requirements.
The output shows each check and its status. If a check fails, it includes recommendations on how to fix the issue.
Some defaults differ per cloud provider (AWS, GCP) so our preflight checks also differ per cloud provider. The preflight checks default to the AWS checks, but this can be changed with:
To validate against a custom StorageClass:
Required Permissions
The user or service account executing kubectl preflight needs read access to the following:
A principal with the built-in view ClusterRole plus view access to the relevant namespaces is sufficient. Last modified on August 7, 2026
