kots pull

If you’d rather use kubectl or another workflow to deploy to your cluster, you can run kots pull to create a directory on your workstation with the Kots application and the Kubernetes manifests. This workflow is necessary when managing a KOTS application without the use of the admin console (kotsadm).


kubectl kots pull [upstream uri] [flags]
  • Replace [upstream-uri] with the URI for your KOTS application (required).
  • If the KOTS application has been packaged by Replicated Vendor, the --license-file flag must be provided.
  • Provide [flags] according to the table below
Flag Type Description
--downstream strings the list of any downstreams to create/update
--exclude-admin-console bool set to true to exclude the admin console (only valid when [upstream-uri] points to a replicated app)
--exclude-kots-kinds bool set to true to exclude rendering kots custom objects to the base directory (default true)
-h, --help help for pull
--image-namespace string the namespace/org in the docker registry to push images to (required when --rewrite-images is set)
--license-file string path to a license file (required when [upstream-uri] points to a replicated app)
--local-path string specify a local-path to pull a locally available replicated app (only valid when [upstream-uri] points to a replicated app)
-n, --namespace string namespace to render the upstream to in the base (default "default")
--registry-endpoint string the endpoint of the local docker registry to use when pushing images (required when --rewrite-images is set)
--repo string repo uri to use when downloading a helm chart
--rewrite-images bool set to true to force all container images to be rewritten and pushed to a local registry
--rootdir string root directory that will be used to write the yaml to (default "/path/")
--set strings values to pass to helm when running helm template
--shared-password string shared password to use when deploying the admin console


kubectl kots pull sentry/unstable --license-file ~/license.yaml
kubectl kots pull helm://stable/elasticsearch