Hi, I’m the Toradex AI Assistant.
I might make mistakes. Our support team will step in if needed. If I answered your question, please tick the “Solution” checkbox. For follow-up questions to me, please use @ToradexAI in your post.
Did you like my answer? 
Hello, and thank you for your detailed description of the issue.
You are correct in your assessment: the deployment limitation is due to how the Torizon IDE extension uses a local Docker registry on your development machine, which the target device must access during deployment and debugging. The documentation and community discussions confirm that the extension is designed with the expectation that both the development PC and the Toradex device are on the same subnet (matching the first three octets), typically within a 255.255.255.0 (or /24) network mask(1)(2). There is currently no documented or configurable option in the IDE or extension to relax this requirement to use a broader subnet mask like 255.255.0.0 (or /16).
Why this limitation exists:
The target device needs to reach the Docker registry on your workstation. With split or routed subnets, automatic discovery or accessibility can break due to:
- Docker registry bindings that default to only listening on local addresses.
- Workstation firewalls or Windows network policies that block cross-subnet requests.
- Lack of explicit network routing between the subnets.
What you can do:
-
Ensure Network Routing Exists:
Double-check that the subnets on your corporate network are fully routable between your development PC and device, without restrictions or NAT between them. -
Check Firewalls:
Make sure that firewalls on both the PC (including Windows Firewall) and any corporate network appliances allow incoming connections to the Docker registry port (typically 5000 TCP) across your intended subnets(2). -
Manually Set Docker Registry Host:
You might try setting the Docker registry to listen on all available interfaces (0.0.0.0) rather than just localhost on your workstation, ensuring the Toradex device can reach it directly via IP address. This can require manual adjustments to your Docker configuration and registry setup outside the default Torizon IDE flow. See the following general guide on using Docker registries: Add Dependencies and Tools to an Existing Project. -
Consider DNS/Hosts File Adjustments:
If you encounter name resolution issues, ensure that your device can resolve the hostname or FQDN of your workstation hosting the registry.
Summary:
The Torizon IDE is not currently designed or documented for deployment across routed or non-local subnets without network-level workarounds. The easiest and most reliable workflow is to ensure that both endpoints are within the same /24 subnet as per the documentation. Any other configuration will require in-depth knowledge of Docker, Windows networking, and host/container connectivity troubleshooting. For now, the IDE does not support modifying the subnet mask requirement directly.
If you want to attempt a more advanced network configuration, the steps above may help, but be aware this is not officially supported in the current IDE release.
Best regards,
Toradex AI Assistant.