This repository has been archived by the owner. It is now read-only.
DEPRECATED Heroku Toolbelt plugin to help configure, test and release apps to Heroku using local containers.
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
commands restore deprecated commands Jun 20, 2016
test Add --dockerfile flag to use existing Dockerfile Dec 14, 2015
.gitignore rename into @heroku org, drop deprecated commands, add verbose flag Jun 6, 2016
LICENSE add license May 4, 2015
Makefile rename heroku-docker to heroku-container-tools Jun 3, 2016
index.js add noop so plugin uninstalls correctly Jan 5, 2018
package.json 4.0.2 Jan 5, 2018

Heroku Container Tools CLI plugin

/!\ This plugin is deprecated. Please see our Container Registry and Runtime instead.

Heroku Toolbelt plugin to help configure, test and release apps to Heroku using local containers.


$ heroku plugins:install heroku-container-tools


$ heroku help container
Usage: heroku container

  Use containers to build and deploy Heroku apps

Additional commands, type "heroku help COMMAND" for more details:

  container:init     #  create Dockerfile and docker-compose.yml
  container:release  #  create and release slug to app

For help with a particular command:

$ heroku help container:init
Usage: heroku container:init

   -i, --image IMAGE   # the Docker image from which to inherit
   -f, --force         # overwrite existing Dockerfile and docker-compose.yml

  Creates a Dockerfile and docker-compose.yml for the app specified in app.json

Developing and contributing

Checkout the plugin source code and tell the Heroku CLI to use your local version of the plugin (instead of the default one distributed with NPM).

$ git clone
$ cd heroku-container-tools
$ npm install
$ heroku plugins:link .


The mapping from Heroku add-on specified in app.json to container configured in docker-compose.yml is tracked in lib\app.json. The mapping currently includes a limited subset of add-ons that we have tested. We welcome additions in the form of PRs.