diff --git a/docs/recipes/mirror.md b/docs/recipes/mirror.md index 021b7d0b..78e4f34d 100644 --- a/docs/recipes/mirror.md +++ b/docs/recipes/mirror.md @@ -100,3 +100,33 @@ to make the change persistent. ``` Save the file and restart Docker for the change to take effect. + +## Use case: the China registry mirror + +The URL of the registry mirror for China is `registry.docker-cn.com`. You can +pull images from this mirror just like you do for other registries by +specifying the full path, including the registry, in your `docker pull` +command, for example: + +```bash +$ docker pull registry.docker-cn.com/library/ubuntu +``` + +You can configure the Docker daemon with the `--registry-mirror` startup +parameter: + +```bash +$ docker --registry-mirror=https://registry.docker-cn.com -d +``` + +Or you can add "https://registry.docker-cn.com" to the `registry-mirrors` +array in `/etc/docker/daemon.json` to pull from the China registry mirror +by default. + +```json +{ + "registry-mirrors": ["https://registry.docker-cn.com"] +} +``` + +Save the file and restart Docker for the change to take effect. \ No newline at end of file