github.com/npaton/distribution@v2.3.1-rc.0+incompatible/docs/recipes.md (about)

     1  <!--[metadata]>
     2  +++
     3  title = "Recipes"
     4  description = "Fun stuff to do with your registry"
     5  keywords = ["registry, on-prem, images, tags, repository, distribution, recipes, advanced"]
     6  +++
     7  <![end-metadata]-->
     8  
     9  # Recipes
    10  
    11  You will find here a list of "recipes", end-to-end scenarios for exotic or otherwise advanced use-cases.
    12  
    13  Most users are not expected to have a use for these.
    14  
    15  ## Requirements
    16  
    17  You should have followed entirely the basic [deployment guide](deploying.md).
    18  
    19  If you have not, please take the time to do so.
    20  
    21  At this point, it's assumed that:
    22  
    23   * you understand Docker security requirements, and how to configure your docker engines properly
    24   * you have installed Docker Compose
    25   * it's HIGHLY recommended that you get a certificate from a known CA instead of self-signed certificates
    26   * inside the current directory, you have a X509 `domain.crt` and `domain.key`, for the CN `myregistrydomain.com`
    27   * be sure you have stopped and removed any previously running registry (typically `docker stop registry && docker rm -v registry`)
    28  
    29  ## The List
    30  
    31   * [using Apache as an authenticating proxy](apache.md)
    32   * [using Nginx as an authenticating proxy](nginx.md)
    33   * [running a Registry on OS X](osx-setup-guide.md)
    34   * [hacking the registry: build instructions](building.md)
    35   * [mirror the Docker Hub](mirror.md)