The most common issues you can encounter with a Domotz Agent installed on a Microsoft Windows OS are the following:
- Domotz does not discover any device on the network
- Domotz we app displays the so-called “orange bar” that states “It looks like there may be network delays…”
- The Domotz Agent is offline even if, by all means, it should be online and you do not understand why
In this article, you will be able to find why this might happen, and how you can try to troubleshoot your Windows Domotz Agent.
Domotz does not discover any device on the network
If Domotz is not detecting any devices on the network, it could be due to one or more of the following reasons:
- Unsupported Windows version
- Unsupported/missing Npcap library
- Missing or incorrect version of the Microsoft Visual C++ (x86) Redistributable package
1 – Check your Windows version
We do officially support from Windows 10 and from Windows 2019 Server onwards.
So, if you are using an older Windows version, and you are not able to install the Domotz Agent on another computer that runs a Windows OS supported version, you might install a hypervisor (a virtual machine host) and deploy one of our pre-configured Linux-based virtual machines.
We do support the following hypervisors and we do ship a pre-configured Domotz Agent:
- Oracle Virtual Box: https://help.domotz.com/user-guide/domotz-installation-virtual-box/
- VMware ESXi: https://help.domotz.com/user-guide/domotz-installation-vmware-esxi/
- Microsoft HyperV: https://help.domotz.com/user-guide/domotz-installation-hyper-v/
- Proxmox: https://help.domotz.com/user-guide/domotz-installation-proxmox/
2 – Check your Npcap library version
If your Microsoft Windows OS version is ok, you might check for an issue with the Npcap library.
Please perform the following tasks in order:
1) From “Program and Features”, uninstall the Npcap library (your version might differ from the one in the following screenshot):
2) Uninstall the Domotz Agent:
3) Install the Domotz Agent again.
This will ensure that the Ncap library version is installed since it is shipped with the Domotz Agent.
4) Reboot your Windows machine (N.B. This is a mandatory step, without rebooting the Agent will not start working).
3 – Verify the Installed Version of Microsoft Visual C++ Redistributable (x86)
Our software requires Microsoft Visual C++ 2015-2019 Redistributable (x86) version 14.29.30156 or newer to be installed.
Uninstalling a Program in Windows Control Panel
1. Open the Control Panel and navigate to "Programs" then "Programs and Features".
2. In the "Uninstall or change a program" section, find the list of installed programs.
3. Locate "Microsoft Visual C++ 2015-2022 Redistributable (x86) - 14.42.34438" in the list.
4. Check details such as publisher "Microsoft Corporation", installed date "2/12/2025", size "18.1 MB," and version "14.42.34438.0".
5. To uninstall, select the program and choose "Uninstall" from the available options at the top.
If the installed version is older or missing, you can download the minimum required version (14.29.30156) from the following link: Download Microsoft Visual C++ 2015-2019 Redistributable (x86)
The Domotz Web App displays the so-called “orange bar” – “It looks like there may be network delays”
This is usually due to Firewall restrictions on OUTGOING connections.
Please make sure that the computer you have installed the Domotz Agent on is able to reach the following hosts/port.
GLOBAL (Every area uses these services)
- portal.domotz.com (port 443 TCP)
- echo.domotz.com (ICMP)
NORTH AMERICA
- api-us-east-1-cell-1.domotz.com (port 443 TCP)
- messaging-us-east-1-cell-1.domotz.com (port 5671 TCP)
- us-east-1-sshg.domotz.co, us-east-1-02-sshg.domotz.co and us-west-2-sshg.domotz.co (range: 32700 – 57699 TCP) – these are required for the Remote Connection functionality.
EUROPE/REST OF WORLD
- api-eu-west-1-cell-1.domotz.com and api-us-east-1-cell-1.domotz.com (port 443 TCP)
- messaging-eu-west-1-cell-1.domotz.com (port 5671 TCP)
- sshg.domotz.co (range: 32700 – 57699 TCP) – these are required for the Remote Connection functionality.
APAC
- api-eu-west-1-cell-1.domotz.com and api-us-east-1-cell-1.domotz.com (port 443 TCP)
- messaging-eu-west-1-cell-1.domotz.com (port 5671 TCP)
- ap-southeast-2-sshg.domotz.co(range: 32700 – 57699 TCP) – these are required for the Remote Connection functionality.
In addition, please make sure to use at least one DNS server option as a public one like the Google DNS server (8.8.8.8 or 8.8.4.4).
How to check if your computer is able to reach these hosts/ports
For echo.domotz.com open a cmd terminal and perform a:
ping echo.domotz.com
For the other hosts/ports, open a PowerShell terminal to and run the following command for each host/port.
Test-NetConnection -ComputerName $host -Port $port
For example (test succeded):
PowerShell Command for Testing Network Connection
1. Open Windows PowerShell.
2. Enter the command: `Test-NetConnection -ComputerName portal.domotz.com -Port 443`.
3. Review the output details:
- ComputerName: Confirms the target website, portal.domotz.com.
- RemoteAddress: Displays the IP address, 52.30.7.143.
- RemotePort: Shows the port number, 443.
- InterfaceAlias: Indicates the network interface, Wi-Fi.
- SourceAddress: Displays the local IP address, 192.168.1.114.
- TcpTestSucceeded: Shows a value of True if the connection is successful.
For example (test FAILED):
Testing Network Connection Error in PowerShell
1. Open a PowerShell window.
2. Enter the command: `Test-NetConnection -ComputerName wrongaddr.domotz.com -Port 443`.
3. Observe the warning message: "Name resolution of wrongaddr.domotz.com failed," indicating that the domain name cannot be resolved.
4. Review the results:
- `ComputerName`: wrongaddr.domotz.com
- `PingSucceeded`: False
The failure indicates an issue with domain name resolution, which prevents successful connectivity tests.
Please test carefully each of the above-listed hosts.
Note: Beware if there is any limit on the number of outgoing connections for the above hosts/port.
The Domotz Agent is showed offline even if it should be online
Your Agent is still shown offline even if everything seems to be ok?
1. Please download our troubleshooting PowerShell script from here:
https://github.com/domotz/support_scripts/raw/main/windows_agent/domotz_win_diagnostics_ps1.zip
2. Run it with administrative privileges.
3. The script will create a zip file on your desktop. Please send us an email at support@domotz.com with the file attached. This will automatically create a support ticket and we will be able to investigate further why our Agent is not working properly.