Skip to main content

Discover Devices with the Network Scanner

Goal: find network hardware on the LAN and commission it without typing addresses by hand.

GEM can sweep the network, identify likely devices, suggest a driver, and pre-fill the device editor for you.

Before you start​

  • You're logged in as an administrator.
  • GEM is on the same network segment as the equipment you want to find.

Run a scan​

  1. Open Devices and click Scan Network in the header.

    Open Devices

  2. The scanner runs an ARP sweep of the broadcast domain and, optionally, a TCP port scan to identify services. Each result shows:

    • the host's IP and MAC,
    • the vendor (derived from the MAC OUI),
    • open ports, and
    • a suggested driver with a confidence score.

  3. Hosts already linked to a GEM device show an Already in GEM pill with the device label and ID — click the IP to jump straight to that device.

Import a discovered device​

  1. Click Import on a new host.
  2. The device editor opens prefilled with the discovered IP, MAC, and a sensible port (443 if open, otherwise 80, otherwise the single open port).
  3. Confirm or change the driver, set a Label, and add any driver-specific attributes.
  4. Save. The discovered ip, port, and mac_address are written to the device as read-only attributes.

From here it's the same as a manual commission — see Commission a Device to verify and add zones.

:::note Full scan controls live on Monitoring The Scan Network modal is a focused, in-context view. The complete scan controls — interface picker, custom IP and port ranges, Quick Scan, and bulk-monitor creation — live on the Monitoring page's Scan tab. :::

  • Commission a Device — the manual path and post-import steps.
  • Monitoring and Devices in the Admin Reference.