Docker Container Options
Introduced in 0.3.17
Pass options to Docker during Dokku's
docker-options:add <app> <phase(s)> OPTION # Add Docker option to app for phase (comma-separated phase list) docker-options:remove <app> <phase(s)> OPTION # Remove Docker option from app for phase (comma-separated phase list) docker-options:report [<app>] [<flag>] # Displays a docker options report for one or more apps
When specifying multiple phases, they must be comma-separated without spaces in between each phase, like so:
About Dokku phases
Dokku deploys your application in multiple "phases" and the
docker-options plugin allows you to pass arguments to their underlying docker container:
build: the container that executes the appropriate buildpack
deploy: the container that executes your running/deployed application
run: the container that executes any arbitrary command via
Add Docker options
Add some options for the deployed/running app and when executing
When mounting a host directory in a Dokku app you should first create that directory as user
dokku and then mount the directory under
/app in the container using
docker-options as above. Otherwise the app will lack write permission in the directory.
Remove a Docker option
Displaying docker-options reports for an app
Introduced in 0.8.1
You can get a report about the app's docker-options status using the
=====> node-js-app docker options information Docker options build: Docker options deploy: -v /var/log/node-js-app:/app/logs Docker options run: -v /var/log/node-js-app:/app/logs =====> python-sample docker options information Docker options build: Docker options deploy: Docker options run: =====> ruby-sample docker options information Docker options build: Docker options deploy: Docker options run:
You can run the command for a specific app also.
You can pass flags which will output only the value of the specific information you want. For example:
In your applications folder
/home/dokku/app_name create a file called
Inside this file list one Docker option per line. For example:
The above example will result in the following options being passed to Docker during
You may also include comments (lines beginning with a #) and blank lines in the DOCKER_OPTIONS file.
More information on Docker options can be found here: https://docs.docker.com/engine/reference/commandline/run/.