Skip to content

Commit 3f2b867

Browse files
committed
Added section explaining how RAM configurations restricting Docker hub interacts with mirror registries
1 parent 0c89cc7 commit 3f2b867

File tree

1 file changed

+17
-0
lines changed
  • content/manuals/docker-hub/image-library

1 file changed

+17
-0
lines changed

content/manuals/docker-hub/image-library/mirror.md

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -45,6 +45,23 @@ Hub can be mirrored.
4545
The Registry can be configured as a pull through cache. In this mode a Registry
4646
responds to all normal docker pull requests but stores all content locally.
4747

48+
### Using Registry Access Management (RAM) with a registry mirror
49+
50+
If Docker Hub access is restricted via your Registry Access Management (RAM) configuration, you will not be able to pull images originating from Docker Hub even if the images are available in your registry mirror.
51+
52+
You may encounter an error like:
53+
```bash
54+
Error response from daemon: Access to docker.io has been restricted by your administrators.
55+
```
56+
57+
This happens because RAM restrictions are enforced at the API proxy layer, meaning the request is blocked before Docker Desktop even attempts to pull from a registry mirror or fall back to Docker Hub.
58+
59+
If you are unable to allow access to Docker Hub, you can manually pull from your registry mirror and optionally, retag the image. For example:
60+
```
61+
docker pull <your-registry-mirror>/library/busybox
62+
docker tag <your-registry-mirror>/library/busybox:latest busybox:latest
63+
```
64+
4865
## How does it work?
4966

5067
The first time you request an image from your local registry mirror, it pulls

0 commit comments

Comments
 (0)