docker app install


Install an application

This command is experimental on the Docker client.

It should not be used in production environments.

To enable experimental features in the Docker CLI, edit the config.json and set experimental to enabled. You can go here for more information.


docker app install [APP_NAME] [--name INSTALLATION_NAME] [--target-context TARGET_CONTEXT] [OPTIONS]

Extended description

Install an application. By default, the application definition in the current directory will be installed. The APP_NAME can also be:

  • a path to a Docker Application definition (.dockerapp) or a CNAB bundle.json
  • a registry Application Package reference

For example uses of this command, refer to the examples section below.


Name, shorthand Default Description
--credential-set Use a YAML file containing a credential set or a credential set present in the credential store
--insecure-registries Use HTTP instead of HTTPS when pulling from/pushing to those registries
--kubernetes-namespace Kubernetes namespace to install into
--name Installation name (defaults to application name)
--orchestrator Orchestrator to install on (swarm, kubernetes)
--parameters-file Override parameters file
--pull Pull the bundle
--set , -s Override parameter value
--target-context Context on which the application is installed (default: )
--with-registry-auth Sends registry auth


$ docker app install myapp.dockerapp --name myinstallation --target-context=mycontext $ docker app install myrepo/myapp:mytag --name myinstallation --target-context=mycontext $ docker app install bundle.json --name myinstallation --credential-set=mycredentials.yml

Parent command

Command Description
docker app Docker Application
Command Description
docker app bundle Create a CNAB invocation image and bundle.json for the application
docker app completion Generates completion scripts for the specified shell (bash or zsh)
docker app init Initialize Docker Application definition
docker app inspect Shows metadata, parameters and a summary of the Compose file for a given application
docker app install Install an application
docker app list List the installations and their last known installation result
docker app merge Merge a directory format Docker Application definition into a single file
docker app pull Pull an application package from a registry
docker app push Push an application package to a registry
docker app render Render the Compose file for an Application Package
docker app split Split a single-file Docker Application definition into the directory format
docker app status Get the installation status of an application
docker app uninstall Uninstall an application
docker app upgrade Upgrade an installed application
docker app validate Checks the rendered application is syntactically correct
docker app version Print version information