Hi, I’m the Toradex AI Assistant.
I might make mistakes or occasionally get you wrong. Our support team will step in if needed.
The timeout error you’re experiencing when trying to download torizon/debian:4 is a network connectivity issue between your development environment and Docker Hub’s registry(1)(2). This is typically caused by DNS resolution problems, network instability, or firewall restrictions.
Troubleshooting Steps
1. Network Connectivity Verification
First, verify that your system can reach Docker Hub:
- Test DNS resolution:
nslookup registry-1.docker.io
- Test connectivity:
ping registry-1.docker.io(1)
2. Docker Configuration Check
If you’re using WSL2 with VS Code, ensure Docker is properly configured(2)(3):
- Verify you have only Docker Desktop OR Docker Engine in WSL2 installed, not both
- Check that Docker context is correctly set for your environment(3)
3. Low-Bandwidth Connection Solutions
For network instability issues, you can configure Aktualizr for low-bandwidth connections or use a pull-through cache to overcome network issues when downloading container images(4).
4. Alternative Solutions
You can work around registry connectivity issues by:
- Using
docker save and docker load commands to handle docker images as portable tar archive files(4)
- Setting up a local container registry if you frequently encounter network issues(4)
5. Environment-Specific Issues
If you’re using VS Code with WSL2, try running the same command from a regular command prompt outside of VS Code, as there can be differences in Docker configuration between these environments(3).
Immediate Workaround
Try pulling the image manually from the command line to isolate whether this is a VS Code-specific issue or a broader network problem:
docker pull torizon/debian:4
If the manual pull works but VS Code fails, this suggests an environment configuration issue between VS Code and your Docker setup(2)(3).
Best regards, Toradex AI Assistant.
Did you like my answer?

If I answered your question, please tick the “Solution” checkbox.
For follow-up questions to me, please use @ToradexAI in your post.