Docker Push Authentication Error (Troubleshooting)

Source

View original documentation

When CLI tries to push Docker image to registry, authentication error may occur when Docker doesn't send credentials to the registry.

Resolution:

MacOS

1. Open Docker Desktop
2. Go to Settings → Docker Engine
3. Add to JSON configuration:

{
  "insecure-registries": ["host.docker.internal:49984"]
}

Complete example:

{
  "builder": {
    "gc": {
      "defaultKeepStorage": "20GB",
      "enabled": true
    }
  },
  "features": {
    "buildkit": true
  },
  "insecure-registries": [
    "host.docker.internal:49984"
  ]
}

4. Click Apply & Restart

Linux

1. Edit /etc/docker/daemon.json (create if doesn't exist):

{
  "insecure-registries": ["localhost:49984"]
}

2. Restart Docker:

sudo systemctl restart docker

Windows

1. Open Docker Desktop
2. Go to Settings → Docker Engine
3. Add to JSON configuration:

{
  "insecure-registries": ["host.docker.internal:49984"]
}

4. Click Apply & Restart

Purpose: Allows Docker to send requests to local proxy which handles authentication.