### Name

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

### Synopsis

```
kf push APP_NAME [flags]
```

### Examples

```
  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
```

### Flags

`--app-suffix=string`
:   Suffix to append to the end of every pushed App.

`--args=stringArray`
:   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=string`
:   Container registry to push images to.

`--cpu-cores=string`
:   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=string`
:   Docker image to deploy rather than building from source.

`--dockerfile=string`
:   Path to the Dockerfile to build. Relative to the source root.

`--entrypoint=string`
:   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).

`--health-check-http-endpoint=string`
:   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).

`--no-manifest`
:   Do not read the manifest file even if one exists.

`--no-route`
:   Prevents the App from being reachable once deployed.

`--no-start`
:   Build but do not run the App.

`-p, --path=string`
:   If specified, overrides the path to the source code.

`--random-route`
:   Create a random Route for this App if it doesn't have one.

`--route=stringArray`
:   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.

`--task`
:   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.

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

`--vars-file=stringArray`
:   JSON or YAML file to read variable substitutions from. Can be supplied multiple times.

### Inherited flags

These flags are inherited from parent commands.

`--as=string`
:   Username to impersonate for the operation.

`--as-group=strings`
:   Group to impersonate for the operation. Include this flag multiple times to specify multiple groups.

`--config=string`
:   Path to the Kf config file to use for CLI requests.

`--kubeconfig=string`
:   Path to the kubeconfig file to use for CLI requests.

`--log-http`
:   Log HTTP requests to standard error.

`--space=string`
:   Space to run the command against. This flag overrides the currently targeted Space.