docker app install

Install an application

This command is deprecated.

It may be removed in a future Docker version. For more information, see the Docker Roadmap.


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

Refer to the options section for an overview of available OPTIONS for this command.


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: <current-context>)
--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 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 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