The Dockerfile is a series of instructions that indicate how Docker should build an image for your app when you use Dockerfile Deploy.

To build your Dockerfile on Aptible Deploy, the file must be named Dockerfile, and located at the root of your repository.

To familiarize yourself with Dockerfiles, we recommend building your app locally using docker build .

Build Timeout

If it takes Aptible Deploy longer than 30 minutes to build your image from the Dockerfile, the deploy operation will time out. If your image takes longer to build, consider using Direct Docker Image Deploy.


Here are a few resources to write your Dockerfile:

First, we recommend familiarizing yourself with Docker by following parts 1 (Orientation) and 2 (Containers) of Docker's "Get Started" guide

Second, we provide Dockerfile samples in our Quickstart Guides. Check those out next: perhaps we have an example for the language or framework you're using. If not, consider Googling for your app framework + Dockerfile. This will usually yield useful results!

Finally, if you're stuck, reach out to Aptible Support: we have accumulated substantial experience helping customers get started with a Dockerfile and we're happy to help you get yours off the ground.

Did this page help you?