Skip to main content

upstream upgrade

The kots upstream upgrade fetches the latest version of the upstream application. It is functionality equivalent to clicking the "Check For Updates" in the admin console.


kubectl kots upstream upgrade [app-slug] [flags]
  • Replace [app-slug] with the app slug for your KOTS application (required).
  • Provide [flags] according to the table below
-h, --helphelp for upstream
--kubeconfigstringthe kubeconfig to use (default is $KUBECONFIG. If unset, then $HOME/.kube/config)
-n, --namespacestringthe namespace where the admin console is running (required)
--deployboolensures the latest available release is deployed
--deploy-version-labelstringensures the release with the provided version label is deployed
--skip-preflightsboolset to true to skip preflight checks
--airgap-bundlestringpath to the application airgap bundle where application images and metadata will be loaded from
--kotsadm-namespacestringthe registry namespace to use for application images
--kotsadm-registrystringthe registry endpoint where application images will be pushed
--registry-passwordstringthe password to use to authenticate with the registry
--registry-usernamestringthe username to use to authenticate with the registry
--disable-image-pushboolset to true to disable images from being pushed to private registry
--waitboolset to false to download the updates in the background (defaults to true)
-o, --outputstringoutput format (currently supported: json) (defaults to plain text if not set)

About Strict Preflight Checks

If any strict preflight checks are configured, the --skip-preflights flag is not honored because preflight checks must run and contain no failures before the application is deployed.

When the --deploy option is provided and there are strict preflight checks, the preflight checks always run. The deployment waits for up to 15 minutes for the preflight checks to complete. If the checks complete without strict preflight failures, the release deploys. If the checks do not complete within 15 minutes, the release does not deploy. If there are one or more strict preflight failures, the release does not deploy.

For more information about strict preflight checks, see About Preflight Checks and Support Bundles.


kubectl kots upstream upgrade kots-sentry --namespace kots-sentry