Device TCP/UDP Ports/Services discovery

2 MIN

HOME PAGE

2 min

Domotz, by default, scans the following ports on every device, in order to provide a list of open ports available on each device.

TCP Ports

21 (FTP)
22 (SSH)
23 (TELNET)
25 (SMTP)
53 (DNS)
79 (FINGER)
80 (HTTP)
110 (POP3)
135 (VMI)
139 (Netbios)
143 (IMAP and IMAP StartTLS)
179 (BGP)
194 (IRC)
220 (IMAP3)
389 (LDAP)
443 (HTTPS)
445 (SMB)
548 (AFP – Apple Filing Protocol)
587 (SMTP – StartTLS)
625 (Open Directory)
993 (IMAP – SSL)
995 (POP3 – SSL)
1433 (Microsoft SQL)
3000 (Domotz)
3306 (MySQL)
3389 (RDP)
5000 (UPnP)
5432 (Postgres)
5900 (VNC)
5985 (WinRM)
8000 (alternate HTTP)
8001 (alternate HTTP)
8080 (alternate HTTP)
8888 (alternate HTTP)
9389 (Active Directory)
27017 (MongoDB)

UDP Ports

53 (DNS)
67 (DHCP)
123 (NTP)
161 (SNMP)

Public API link: https://portal.domotz.com/developers/#getdevice

SSH Protocol Ports Customization

Some devices expose their services on non-standard ports. From the Collector’s Monitoring Configuration you can define a custom SSH port that applies to all the devices of that Collector, instead of relying only on the standard port 22.

Where to find this setting

From the Collectors list, select the Collector you want to configure.
Once in the Collector’s Devices view, click the Collector tab in the top menu.
Scroll to the Monitoring Configuration section.
Locate the Port Scanning area.
Next to SSH – 22, enter the additional port you want Domotz to scan (e.g. 2222), then save.

Please note

Only one custom port can be defined at the moment.
SSH is the only protocol currently supported.
Port 22 is always scanned, regardless of the custom port you configure. The custom port is scanned in addition to it, never instead of it.
The setting applies to all the devices monitored by that Collector, not to a single device.

Configuring the custom port via the Public API

The same value can be set programmatically:

PUT /agent/{agent_id}/service-port/{service_port_protocol}

curl https://api-eu-west-1-cell-1.domotz.com/public-api/v1/agent/{collector-id}/service-port/SSH \
  --request PUT \
  --header 'Accept: */*' \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <YOUR_API_KEY>' \
  --data '{
  "port": 2222
}'

Replace {collector-id} with the ID of your Collector and use the API endpoint matching your account’s region. The port 2222 is only an example — enter the SSH port actually in use on your devices.

Public API link: https://portal.domotz.com/developers/#tag/network-configuration/PUT/agent/{agent_id}/service-port/{service_port_protocol}