Preparing an Application

Convox infers information about your application from the following files:


This file documents the steps necessary to build your application into an executable artifact.


This file describes the structure of your application and how the pieces connect to each other.


If you don’t yet have these files in your application, Convox can build them for you.

$ convox init

Running this command will create a default Dockerfile and docker-compose.yml that you can use to get started.

These files are generated to take advantage of Heroku’s open-source buildpacks. To read more about how that works, check out the convox init reference.

If you’d rather write your own files or already use Docker in your application, refer to the Docker Compose File and Dockerfile references to see how they work with Convox.