Skip to main content
Version: 5.2.0

Configuration

This page describes all Helm configuration options available for installing and customizing Cosmopilot. These settings allow you to tailor the deployment to your specific needs.

You can find the full list of available Helm values here, or you can run:

$ helm show values oci://ghcr.io/voluzi/helm/cosmopilot

General Settings​

replicas​

  • Description: Number of replicas for the Cosmopilot deployment. If more than one, leader election will be enabled.
  • Default: 1

probesEnabled​

  • Description: Enable or disable health and readiness probes for cosmopilot deployment.
  • Default: true

image​

  • Description: The container image repository for the Cosmopilot operator.
  • Default: ghcr.io/voluzi/cosmopilot

imageTag​

  • Description: The tag with the version to be used.
  • Default: The chart's application version.

imagePullPolicy​

  • Description: Pull policy of the Cosmopilot manager container. Set Always when imageTag is a moving tag such as edge, so a restarted manager runs the newest build.
  • Default: "" (the Kubernetes default, IfNotPresent for a version tag)

The companion-image values below are optional overrides. Their Helm defaults are empty, so the selected manager release supplies its pinned, compatible image defaults. Upgrading the manager can therefore upgrade its companions as one release. Explicit values remain pinned across upgrades, including upgrades that use --reuse-values; clear or delete an old value to resume release defaults.

Companion images with a moving tag (edge or latest) or no tag at all are pulled Always, so a restarted Pod runs the newest build. Every push to cosmopilot main publishes edge builds of the manager, node-utils, node-tools and dataexporter, plus an immutable edge-<short sha> tag of each. Images with a version tag or digest keep their usual pull policy.

nodeUtilsImage​

  • Description: The container image of node-utils (with version tag included). This is a container deployed by cosmopilot as a sidecar with helper methods for calculating data size, handling upgrades, and a few more utilities.
  • Default: "" (inherits the pinned default from the selected manager release)
node-utils compatibility

If you override or pin nodeUtilsImage, use node-utils 4.0.0 or newer. This version provides the wait-for-signer startup gate as well as polling and SDK marker-based upgrade coordination. When both custom app and Pod security contexts are supplied, their effective combination must set numeric runAsUser and runAsGroup values so node-utils can read the SDK marker with the application's filesystem identity.

cosmoGuardImage​

  • Description: The container image of CosmoGuard (with version tag included) used for the standalone CosmoGuard StatefulSets.
  • Default: "" (inherits the pinned default from the selected manager release)

cosmoseedImage​

  • Description: The container image of Cosmoseed (with version tag included). Used when deploying seed nodes.
  • Default: "" (inherits the pinned default from the selected manager release)

cosmosignerImage​

  • Description: The default container image of Cosmosigner (with version tag included), used when deploying managed remote signers. Can be overridden per-signer with .spec.cosmosigner.image.
  • Default: "" (inherits the pinned default from the selected manager release)

Cosmopilot 5.0.0 defaults to Cosmosigner 3.1.1 and requires its HTTP health endpoints and bounded redial. The image is not version-checked: with an older build /livez never answers, the signer never becomes live, and the validator does not sign until the image is corrected.

dataExporterImage​

  • Description: The container image of Data Exporter (with version tag included) used by snapshot tarball upload and deletion Jobs and exported-snapshot data initialization.
  • Default: "" (inherits the pinned default from the selected manager release)

Exported-snapshot restore requires Data Exporter 2.1.0 or newer, which adds the S3 and GCS restore commands. An older override fails during data initialization; update or clear the override.

utilityImage​

  • Description: Versioned utility image used by operator-owned helper containers for genesis, configuration, PVC, and snapshot integrity operations. Overrides may use a tag or digest and must provide the commands used by these helpers, including standard file utilities, jq, wget, gunzip, zstd, pidof, and nc.
  • Default: "" (inherits the pinned default from the selected manager release)

imagePullSecrets​

  • Description: Secrets for pulling the Cosmopilot manager image. Helper Pods run in the ChainNode namespace and use namespace-local secrets from .spec.config.imagePullSecrets instead.
  • Default: []

Worker Configuration​

workerCount​

  • Description: Maximum number of concurrent reconciles handled by the cosmopilot operator.
  • Default: 10

workerName​

  • Description: Name of the worker. Useful if you need multiple installations of cosmopilot. You can later define on resources which worker to use.
  • Default: "" (empty string)

Features and Functionality​

webHooksEnabled​

  • Description: Enable or disable admission webhooks for validating and mutating requests. Ensure cert-manager is installed before enabling this.
  • Default: true

debugMode​

  • Description: Enable debug mode for additional logs.
  • Default: false

disruptionChecksEnabled​

  • Description: Enable or disable the operator's disruption checks during managed pod replacement.
  • Default: true

disruptionMaxUnavailable​

  • Description: Maximum number of unavailable pods allowed in a disruption domain before the operator defers another ready pod's replacement. This is a global setting for all ChainNodes, including validators; it must be at least 1. A syncing pod counts as unavailable by default; when config.ignoreSyncing: true, its readiness probe uses /health, so it may count as available.
  • Default: 1

Pod Priority Settings​

nodesPodPriority​

  • Description: Priority for pods representing blockchain nodes.
  • Default: 950

validatorPodPriority​

  • Description: Priority for validator pods.
  • Default: 1050

defaultPriority​

  • Description: Default pod priority for all pods without specific roles.
  • Default: 0

Node Configuration​

nodeSelector​

  • Description: Node selectors to control where Cosmopilot components are scheduled.
  • Default: {} (no specific node selector)