kf push

Stay organized with collections Save and categorize content based on your preferences.


kf push - Create a new App or apply updates to an existing one.


kf push APP_NAME [flags]


kf push myapp
kf push myapp --buildpack my.special.buildpack # Discover via kf buildpacks
kf push myapp --env FOO=bar --env BAZ=foo
kf push myapp --stack cloudfoundry/cflinuxfs3 # Use a cflinuxfs3 runtime
kf push myapp --health-check-http-endpoint /myhealthcheck # Specify a healthCheck for the app



Suffix to append to the end of every pushed App.


Override the args for the image. Can't be used with the command flag.

-b, --buildpack=string

Use the specified buildpack rather than the built-in.

-c, --command=string

Startup command for the App, this overrides the default command specified by the web process.


Container registry to push images to.


Number of dedicated CPU cores to give each App instance (for example 100m, 0.5, 1, 2). For more information see https://kubernetes.io/docs/tasks/configure-pod-container/assign-cpu-resource/.

-k, --disk-quota=string

Size of dedicated ephemeral disk attached to each App instance (for example 512M, 2G, 1T).


Docker image to deploy rather than building from source.


Path to the Dockerfile to build. Relative to the source root.


Overwrite the default entrypoint of the image. Can't be used with the command flag.

-e, --env=stringArray

Set environment variables. Multiple can be set by using the flag multiple times (for example, NAME=VALUE).


HTTP endpoint to target as part of the health-check. Only valid if health-check-type is http.

-u, --health-check-type=string

App health check type: http, port (default) or process.

-h, --help

help for push

-i, --instances=int32

If set, overrides the number of instances of the App to run, -1 represents non-user input. (default -1)

-f, --manifest=string

Path to the application manifest.

-m, --memory-limit=string

Amount of dedicated RAM to give each App instance (for example 512M, 6G, 1T).


Do not read the manifest file even if one exists.


Prevents the App from being reachable once deployed.


Build but do not run the App.

-p, --path=string

If specified, overrides the path to the source code.


Create a random Route for this App if it doesn't have one.


Use the routes flag to provide multiple HTTP and TCP routes. Each Route for this App is created if it does not already exist.

-s, --stack=string

Base image to use for to use for Apps created with a buildpack.


Push an App to execute Tasks only. The App will be built, but not run. It will not have a route assigned.

-t, --timeout=int

Amount of time the App can be unhealthy before declaring it as unhealthy.


Manifest variable substitution. Multiple can be set by using the flag multiple times (for example NAME=VALUE).


JSON or YAML file to read variable substitutions from. Can be supplied multiple times.

Inherited flags

These flags are inherited from parent commands.


Username to impersonate for the operation.


Group to impersonate for the operation. Include this flag multiple times to specify multiple groups.


Path to the Kf config file to use for CLI requests.


Path to the kubeconfig file to use for CLI requests.


Log HTTP requests to standard error.


Space to run the command against. This flag overrides the currently targeted Space.