I can't download Docker images on my Synology NAS. What can I do?
Last updated:Oct 24, 2023
I can't download Docker images on my Synology NAS. What can I do?
Symptoms
You are not able to download any images from a registry in the Container Manager (DSM 7.2 and above) or Docker (DSM 7.1.1 and below) package.
Resolution
Identify and troubleshoot the issue
Follow the steps below to pinpoint the causes of the issue and try to download the image again.
- DNS server setting:
Go to Control Panel > Network > General. Select Manually configure DNS server and set the preferred and alternative DNS servers to8.8.8.8
and8.8.4.4
temporarily.1 2 3 - Network interface setting:
Go to Control Panel > Network > Network Interface, select a network interface, and click Edit > IPv6. Make sure the IPv6 setup setting is Off.4 Also, disable the MTU setting in the IPv4 tab.5 - Time setting:
Go to Control Panel > Regional Options > Time, and select Synchronize with NTP server. Select an NTP server and click Update Now to make sure the time shown on your Synology NAS is correct.6 - Storage space:
Go to Storage Manager > Overview and make sure the volume with Container Manager or Docker installed has enough space for downloaded images. - Registry setting:
Access to certain registries may be limited in some of the regions. If the current registry is inaccessible in your region, you can switch to other registries from which you want to download the images. Go to Container Manager or Docker > Registry, and click Settings > Add to set up new registries. - Firewall or proxy server settings:
If you've set up firewall rules or proxy servers, make sure the URLs for Container Manager or Docker are not blocked. - Docker Hub rate limit:
Due to the rate limit of Docker Hub, you might encounter issues downloading the image if the limit is exceeded. Ensure you stay within the limit, and if exceeded, retry the download after the restriction period.
Download images using a command
You can also download the images to your Synology NAS using command lines.
- Sign in to DSM with root privilege via SSH.
- Use the
docker pull
command to download an image. Refer to Docker's documentation for detailed information.
Download and import an image into your Synology NAS
If you have access to another Synology NAS that can connect to the desired registry, you may follow the instructions below.
- On another Synology NAS that can connect to the registry, go to Container Manager or Docker > Registry and download the image.
- Go to the Image page and export the image.
- Send the image to the Synology NAS that cannot connect to the registry.
- Import the image to Container Manager or Docker.
Notes:
- If your Synology NAS is located in China, set the preferred and alternative DNS servers to
114.114.114.114
and223.5.5.5
. - If your Synology NAS has joined a domain, make sure the DNS server of the domain can resolve the URLs required by Container Manager or Docker. For the domain created by Synology Directory Server, you can Enable resolution service and Enable forwarders in the DNS Server package.
- If this step fixes the issue, that means the previous DNS server settings might not be able to resolve the URLs required by Container Manager or Docker. Make sure your DNS server settings can correctly resolve the required URLs.
- If this step fixes the issue, that means the issue might be resulted from IPv6 routing. Make sure your Synology NAS can reach URLs required by Container Manager or Docker via your IPv6 routing.
- Certain models do not support modifying the MTU value. If the MTU value checkbox is not displayed, you can skip this change.
- Learn more about troubleshooting time sync issues with an NTP server if the sync status is abnormal.