Stackfile
To avoid conflicts with the local Docker installation, the stack file is named dockhero-compose.yml. Normally you'll place it in the root of your project and put it under version control. It's a regular Docker Compose stack definition - see docker-compose.yml reference for the syntax.
Minimalistic checklist for those who is impatient:
- declare ports mapping - otherwise your ports are not exposed to the Internet
- use named volumes with local driver for persistence
- use restart and limits options as needed
- use variables substitution for configurable parameters and secrets
Generators
We maintain a repository of pre-defined stacks. You can quickly generate a stackfile via CLI:
heroku dh:generate <stack_name>
See the list of available generators here