Malith-Rukshan/Fix_GHCR_IPv6_Connection_Reset.md

Created December 11, 2025 05:56

Star (1) You must be signed in to star a gist
Fork (0) You must be signed in to fork a gist

Select an option

Learn more about clone URLs
Clone this repository at <script src="https://gist.github.com/Malith-Rukshan/571f5c57b7a8558be966451024eadd6c.js"></script>
Save Malith-Rukshan/571f5c57b7a8558be966451024eadd6c to your computer and use it in GitHub Desktop.

Download ZIP

Fix for ghcr.io read: connection reset by peer ipv6 error ✅

Raw

Fix_GHCR_IPv6_Connection_Reset.md

⚡ Quick Fix: GHCR IPv6 Connection Reset

If you see ghcr.io read: connection reset by peer ipv6 when pulling from GitHub Container Registry, your system might be failing on IPv6.

The fix is to force IPv4 by editing your local hosts file.

📝 The Fix

Locate your hosts file:
- Linux/macOS: /etc/hosts
- Windows: C:\Windows\System32\drivers\etc\hosts

Add these entries to the bottom of the file (requires administrator/sudo rights):

# Force IPv4 for GitHub Container Registry
140.82.121.34 ghcr.io
185.199.108.154 pkg-containers.githubusercontent.com

Save and re-test your docker pull or podman pull command.

This redirects the traffic to known GitHub IPv4 addresses, bypassing the problematic IPv6 connection.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment