// Module included in the following assemblies:
//
// * microshift/microshift_install_get_ready/microshift-deploy-with-mirror-registry.adoc

:_mod-docs-content-type: CONCEPT
[id="microshift-configuring-mirroring-prereqs_{context}"]
= Configuring mirroring prerequisites

[role="_abstract"]
You must create a container image registry credentials file that allows the mirroring of images from your internet-connected mirror host to your air-gapped mirror. Follow the instructions in the "Configuring credentials that allow images to be mirrored" link provided in the "Additional resources" section. These instructions guide you to create a `~/.pull-secret-mirror.json` file on the mirror registry host that includes the user credentials for accessing the mirror.

[id="microshift-example-mirror-pull-secret-entry_{context}"]
== Example mirror registry pull secret entry

In this example, the following section is added to the pull secret file for the `microshift_quay:8443` mirror registry by using `microshift:microshift` as username and password.

.Example mirror registry section for pull secret file
[source,terminal]
----
"<microshift_quay:8443>": {
    "auth": "<microshift_auth>",
    "email": "<microshift_quay@example.com>"
},
----

* Replace the `<registry_host>:<port>` value `microshift_quay:8443` with the hostname and port of your mirror registry server.
* Replace the `_<microshift_auth>_` value with the user password.
* Replace the `_</microshift_quay@example.com>_` value with the user email.
