anchor.diff:  ----
   ====
   
  +[[docker-registry-configuration-reference-auth]]
   ==== auth
   
  -Auth options should not be altered. The **openshift** extension is the only supported
  -option.
  -
  +Auth options should not be altered. The *openshift* extension is the only
  +supported option.
  +
  +====
   ----
   auth:
     openshift:
       realm: openshift
   ----
  -
  +====
  +
  +[[docker-registry-configuration-reference-middleware]]
   ==== middleware
   
  -The **repository** middleware extension should not be altered except for the
  -**options** section to disable pull-through cache.
  +The *repository* middleware extension should not be altered except for the
  +*options* section to disable pull-through cache.
   
   [NOTE]
  -The **middleware** section may not be overridden using environment variables.
  +====
  +The *middleware* section cannot be overridden using environment variables.
  +====
   
   ====
   ----
  
positive.code: 
  [TIP]
  ====
  It is recommended that configuration files be maintained in a source control
  repository.
  ====
  
  [[registry-configuration-reference]]
  
negative.code: 
  You can override the integrated registry's default configuration, found by
  default at *_/config.yml_* in a running registry's container, with your own
  link:#registry-configuration-reference[custom configuration].
  
  [NOTE]
  ====
  Upstream configuration options in this file may also be overridden using
  environment variables. However, the
  link:#docker-registry-configuration-reference-middleware[middleware section] may
  *not* be overridden using environment variables.
  link:https://docs.docker.com/registry/configuration/#override-specific-configuration-options[Learn
  how to override specific configuration options].
  ====
  
  [[docker-registry-deploying-updated-configuration]]
  === Deploying Updated Configuration
  
  To enable management of the registry configuration file directly, mount the
  configuration file as a link:../../dev_guide/secrets.html[secret volume]:
  
  . link:#deploy-registry[Deploy the registry].
  
  . Edit the registry configuration file locally as needed. The initial YAML file
  deployed on the registry is provided below.
  link:#registry-configuration-reference[Review supported options].
  +
  .Registry configuration file
  ====
  