Recipes overview

This page contains information about hosting your own registry using the open source Docker Registry. For information about Docker Hub, which offers a hosted registry with additional features such as teams, organizations, web hooks, automated builds, etc, see Docker Hub.

This list of “recipes” provides end-to-end scenarios for exotic or otherwise advanced use-cases. These recipes are not useful for most standard set-ups.

Requirements

Before following these steps, work through the deployment guide.

At this point, it’s assumed that:

• you understand Docker security requirements, and how to configure your docker engines properly
• you have installed Docker Compose
• it’s HIGHLY recommended that you get a certificate from a known CA instead of self-signed certificates
• inside the current directory, you have a X509 domain.crt and domain.key, for the CN myregistrydomain.com
• be sure you have stopped and removed any previously running registry (typically docker container stop registry && docker container rm -v registry)

The List

• using Apache as an authenticating proxy
• using Nginx as an authenticating proxy
• running a Registry on macOS
• mirror the Docker Hub