The Edge is online, but no devices are reporting
The Edge is Online but every device behind it stays in Never seen. Trace where the connection to your devices breaks.
The Edge shows Online, but the devices behind it sit in Never seen — no status, no telemetry, since the day they were claimed.
Online describes only the Edge's connection to Xyte. It says nothing about whether the Edge can reach your devices — those are two separate network paths, and one can be perfectly healthy while the other reaches nothing.

Online, Up-to-date, synced minutes ago — and not one device behind it has ever reported.
Never seen means a device has never reported since it was claimed, so the problem has existed since day one. That is different from Offline, which means a device reported before and then stopped.
If the Edge itself is not Online, start at The Edge is offline. If only one device is affected, use A device is offline.
1. Ping a device from the portal
Open the Edge agent's device page → Commands → Ping Check, enter the IP of a device that is not reporting, and run it. Leave Print DNS Resolution unchecked when you enter an IP address.

Open the result and read the Message. The packet-loss line is the diagnosis:
| Message | Meaning | Next |
|---|---|---|
Replies, 0% packet loss | The Edge reaches the device. | Step 4 |
0 received, 100% packet loss | Nothing came back. The device is unreachable. | Step 2 |
Destination Host Unreachable | The Edge answered its own ping. | Step 5 |

Status shows Done whenever the command ran — including when the ping failed. Always read the Message.
2. Ping from the Edge host
The Edge uses the host machine's network stack, so "can the Edge reach the device?" is the same question as "can the host reach it?" — which you can test without Xyte:
ping <device-ip>Replies here but a failure in step 1 is worth reporting to [email protected]. Otherwise the device is genuinely unreachable from this machine — continue below.
3. Find what is blocking it
Start with the host's own addressing. A wrong subnet mask is quick to rule out and looks exactly like a firewall block, so check it before anyone changes firewall rules:
ipconfig /all # Windows
ip -brief address # LinuxIf the mask is too narrow, devices that are in fact on the same local network look remote. The host sends their traffic to the default gateway instead of directly to them, and it disappears there.
| Symptom | The Edge stayed Online for weeks. Every device returned 100% packet loss with no error, and firewall changes made no difference. |
| Cause | The host's mask was 255.255.255.252 (a /30) instead of 255.255.252.0 (a /22). The gateway sat inside that /30, so cloud access kept working while every device — which belonged on the same /22 — looked remote and was dropped at the gateway. |
| Fix | Corrected the mask. Every device came online within minutes. |
Then, in order:
- Permit ICMP echo request and reply from the Edge host to each device. This drives the status check on every device, and on heartbeat-only models it is the only signal there is.
- Check the route —
ip route get <device-ip>. If it leaves via the wrong interface, a static route is missing. See Networking. - Open the device's management port — see Requirements. ICMP alone gives online/offline but no telemetry.
- Confirm the device is powered on and still at that address. Xyte does not detect IP changes; update the address on the device in Xyte if it moved.
- Check whether the device restricts management access by source address, and permit the Edge host's IP.
After a host networking fix the Edge picks the change up on its own — restarting the container is optional, and only forces an immediate re-poll.
4. Ping works, but there is still no telemetry
The network is fine and the remaining causes are on the device:
- The management protocol is switched off — SNMP, PJLink, IP Control and similar ship disabled. See Device prerequisites by vendor.
- The SNMP community string does not match. Unless a model exposes a community string parameter, Xyte polls with
public. - Setup parameters are missing — credentials, a port or a device ID entered once after claiming. See User Parameters.
5. Less common causes
| Cause | Sign | Resolution |
|---|---|---|
| Docker Desktop bridge collision | Destination Host Unreachable, device subnet on 172.17.x / 172.18.x | Windows and macOS cannot use host networking, so a Docker bridge exists and can overlap your device subnet. Contact [email protected]. |
| NAT or port forwarding | Several devices behind one appliance are permanently online with near-identical response times | Not supported — the Edge stores one IP per device and must reach it by Layer-3 routing. See Edge Connectivity. |
Still not reporting?
Send [email protected] the Ping Check Message from step 1, the ping output from step 2, the output of ip -brief address and ip route get <device-ip> from the Edge host, and the affected device names with their IP addresses.
Updated 2 minutes ago
