Last modified July 2, 2026

'kubectl gs update app' command reference

Deprecated: This command updates the legacy App custom resource, which is being phased out in favor of Flux HelmRelease. For HelmRelease, update the chart version by editing the OCIRepository’s spec.ref.tag field; values are updated by editing the referenced ConfigMap or Secret. See App management for the conceptual overview.

This command helps with updating App custom resources.

Usage

The command to execute is kubectl gs update app.

It supports the following required flags:

  • --name: Name of the App CR to update.
  • --version: New version to update the app to. The version must exist in the Catalog.

Important: ensure you have selected the correct namespace for your cluster with the --namespace flag.

See the example command updating starboard-app to version 0.2.1:

kubectl gs update app \
  --name starboard-app \
  --namespace ab01c \
  --version 0.2.1

It produces the following output upon success:

App 'starboard-app' updated to version '0.2.1'