Docker Registry

An important part of the Docker ecosystem is a Docker registry. It acts as a folder of images, taking care of their storing and building. Docker Hub is the official Docker registry.

For reliability reasons, we strongly recommend to use the Amazon AWS ECR provisioned by the Keboola Developer Portal. We also support Docker Hub and Quay, both public and private repositories.

Working with Registry

In order to run an image, pull (docker pull) the image to your machine. The docker run command does that automatically for you. So, when you do:

docker run -i

you will see something like this:

Unable to find image '' locally
latest: Pulling from keboola/docker-custom-php
ad74af05f5a2: Pull complete
8fa9669af8ec: Pull complete
Digest: sha256:ff21e0f0e58614aa5d8104d9f263552e583e6ddeb6215e83cae181d5169a150a
Status: Downloaded newer image for
Interactive shell

When you build an image locally, push (docker push) it to the Docker registry. Then the image can be shared with anyone (if public), or with your organization (if private).

Because the image is defined only by the Dockerfile instructions (and optionally build context), you can take a shortcut and give the registry only the Dockerfile. The registry will then build the image on its own infrastructure. This is best done by setting up an automated deploy script or by linking a git repository containing the Dockerfile (and usually the application code) with the registry.

Setting Up Repository on Quay

This may get slightly confusing because we will create a new Image Repository and link that to an existing Github Repository. Use the sample repository created in our tutorial.

Create an account and organization, and then create a new repository:

Create Repository

In the repository configuration, select Link to a Github Repository Push:

Repository configuration

Then link the image repository to a Github repository. You can use our sample repository:

Link repositories

After that, configure the build trigger. The easiest way to do that is setting the trigger to All Branches and Tags. It will trigger an image rebuild on every commit to the repository. You can also set the build trigger only to a specific branch, for example, head/master:

Configure build trigger for branch

An alternative option is to configure the trigger to a specific tag. For Semantic versioning, the following regular expression ^tags/[0-9]+\.[0-9]+\.[0-9]+$ ensures the image is rebuilt only when you create a new tag.

Configure build trigger for tag

Regardless of your chosen approach, finish setting up the trigger by completing the wizard:

Configure build trigger

Pushing a new commit into a git repository or creating a new tag (depending on the trigger setting) will now trigger a new build of the Docker image. Also note that the image automatically inherits the git repository tag or branch name. So, when you push a commit to the master branch, you will get an image with a tag master (which will move away from any older image builds). When creating a 1.0.0 tag, you will get an image with a 1.0.0 tag.

When using images in Keboola, we highly recommend to use our ECR repository.