# How to Get Started with Domotz

## Domotz Onboarding Guide: Setting up Domotz

   Table of Contents

- [Domotz Onboarding Guide: Setting up Domotz within your Free Trial Period](#htoc-domotz-onboarding-guide)
- [Purpose of the Domotz Onboarding Guide](#htoc-purpose-of-the-guide)
- [How Domotz Works](#htoc-how-domotz-works)
- [How to get Started with Domotz](#htoc-how-to-get-started-with-domotz)
- [1 Domotz Account Creation](#htoc-domotz-account-creation)
- [2 Installing your Domotz Collector](#htoc-installing-your-domotz-collector)
- [2.1 Windows Collector Installation](#htoc-windows-collector-installation)
- [3 Configuring the Domotz Collector](#htoc-configuring-the-domotz-collector)
- [3.1 Device Discovery](#htoc-device-discovery)
- [3.1.1 Per Location Model](#htoc-per-location-model)
- [3.1.2 Per Device Model](#htoc-per-device-model)
- [3.2 Setting up SNMP on Network Managed Switches](#htoc-setting-up-snmp-managed-switches)
- [3.3 View Topology Map](#htoc-view-topology-map)
- [3.4 Switch Port Traffic and PoE capabilities](#htoc-switch-port-traffic-poe)
- [3.5 SNMP Pre-configured sensors](#htoc-snmp-pre-configured-sensors)
- [3.6 Setting up your Domotz Alerts](#htoc-setting-up-your-domotz-alerts)
- [3.7 Monitoring your Domotz Collector](#htoc-monitoring-your-domotz-collector)
- [3.8 Monitoring a Specific Device](#htoc-monitoring-a-specific-device)
- [3.9 Creating a Remote Connection](#htoc-creating-a-remote-connection)
- [3.10 AI Agents](#htoc-ai-agents)
- [3.10.1 ChatGPT](#htoc-chatgpt)
- [3.10.2 Claude](#htoc-claude)
- [3.10.3 Other Clients](#htoc-other-clients)
- [3.10.4 Use Natural Language to Manage your Networks](#htoc-natural-language-ai)

## Purpose of the Domotz Onboarding Guide

The Domotz Onboarding Guide will help you deploy Domotz in your network quickly and efficiently.

Once deployed, you will be able to:

- Discover all the devices on your network
- Choose the devices to monitor
- Get a network topology
- Create and manage alerts on your network devices
- Connect remotely to your devices without the need to open ports on your router or install specific software on them

Note that this article focuses on a quick, single-Collector setup to get you up and running. It assumes the account owner is configuring the system and no team members are added. We hope you enjoy the Domotz Onboarding Guide.

## **How Domotz Works**

When getting started with Domotz, it's important to know what we do. Domotz is a cloud-based service that continuously and securely communicates with a network collector. The cloud service is where information about the network you are monitoring is stored and accessed. Accessing your network information is done through the Domotz application, which can be hosted on Windows or Mac OS, as well as your favorite web browser, or even iOS and Android mobile devices.

As a cloud-based service, you’ll first need to create an account. Next, install a Collector on the network you want to monitor. Finally, configure both the application and the Collector to take full advantage of all the features Domotz offers.

## How to Get Started with Domotz

## **1 Domotz Account Creation**

Visit [https://portal.domotz.com](https://portal.domotz.com) and click on "Sign up":

Domotz Pro login screen with sign-up option.

1. Enter your email address in the 'Email' field.
2. Enter your password in the 'Password' field.
3. Optional: Check the box for 'Remember me on this browser' if you want to stay logged in on this device.
4. Click the 'Log in' button to access your account.
5. If you don’t have an account, click 'Sign up' to create a new one.

To register and fill in the mandatory fields: provide an email address, which will serve as your login, and secure your account with a strong password:

Creating a Domotz account.

1. Enter your work email address in the provided input field.
2. Ensure the checkbox is selected to agree to the Terms and Conditions and Privacy Policy.
3. Click the "Continue" button to proceed.

Network Discovery Account Setup

1. Enter your work email address in the provided field to start setting up your Domotz account.

2. Agree to the terms and conditions by checking the relevant box.

3. Look for a verification code sent to your email, then enter it into the "Enter verification code" section.

4. Click the "Verify & Continue" button to proceed. If the code is not received, use the option to resend the email or change the email address if necessary.

Form Completion for User Information

1. Enter your first name in the "First Name" field, which is required.
2. Fill in your last name in the "Last Name" field.
3. Optionally, provide your company name in the "Company Name" field.
4. Select your country from the dropdown menu next to "Country" (e.g., United Kingdom).
5. Optionally, enter your phone number in the "Phone Number (optional)" field.
6. Click the "Continue" button to proceed.

Password Creation Form

1. Enter a password in the "Password" field. Ensure it meets the criteria shown: it cannot include the word "Domotz", must be 8 to 64 characters long, cannot include your email address, and should not be a common or blacklisted password.
2. Verify the strength of your password, which is indicated below the field. If marked as "Weak Password," consider altering it to improve security.
3. Re-enter the same password in the "Confirm Password" field to verify consistency.
4. Click the "Continue" button to proceed after successfully entering a strong, matching password.

Select Your Business Type in Domotz Setup

1. Choose the type of business that best describes your organization. Options include:
   - IT Department/Enterprise for internal infrastructure management.
   - Managed Service Provider for IT services to multiple clients.
   - Integrator - Commercial A/V for professional audiovisual systems.
   - Integrator - Residential A/V for smart home entertainment systems.
   - Integrator - Security/Fire/Safety for safety and security systems.
   - Personal Use for home office or personal projects.

2. After selecting the appropriate category, click the "Continue" button to proceed with the setup.

At this point, your account has been created and you will be automatically logged into your Domotz Webapp portal. You can always return to this page by visiting **[portal.domotz.com/webapp/](https://portal.domotz.com/webapp/)**.

The next step is to install your Domotz Collector.

## **2 Installing your Domotz Collector**

In order to monitor your assets with Domotz, you need to install a Collector on your network. The Domotz Collector is a light-weight software which can be installed on various Operating Systems. The Domotz Collector receives commands from the Domotz cloud service to scan, monitor and connect to systems on the network. It is important to note that this Collector will scan the network that it is associated with. For instance, if you install the Windows Collector on a PC, the collector will scan the network(s) the Windows PC is currently attached to.

Once you complete the account creation, you will be redirected to the page where you can download your Collector. Select your operating system and follow the installation instructions.

Network Discovery Setup Instructions

1. Select your operating system under "Discover your network with ease." Options include Windows, Synology, QNAP, and more. The Windows option is currently selected.
2. To use a different OS, locate “Less deployment options” and choose from systems like Linux, AWS, Debian, RaspberryPi, Ubuntu, and VirtualBox.
3. For Windows, download the necessary file by clicking the “Domotz Collector Installer” button.
4. Explore further guidance or configuration steps by opening any of the expandable sections: "Step by step instructions," "Advanced configurations," and "Security standards."
5. If you are unsure of readiness, consult the "Not ready to deploy?" section for assistance.

For simplicity, this guide will go through the process of installing the Windows Collector. Instructions for other Collector types are available on the "**Add Collector"** page within [portal.domotz.com](https://portal.domotz.com).

### **2.1 Windows Collector Installation**

Installation setup for Domotz Collector on Windows.

1. Select the installation location: The default destination folder is "C:\Program Files (x86)\domotz". Click "Browse" to choose a different folder if needed.

2. Choose the installation type:
   - Select "Set up a new Collector" to install a fresh instance.
   - Select "Migrate an existing Collector to this device" to preserve active licenses and configurations.

3. Check required space: Ensure 260 MB is needed, with 8 GB available.

4. Click "Install" to proceed with the installation, or choose "Back" to review previous steps or "Cancel" to exit the setup.

If the installer was downloaded in the last 6 hours, it will be automatically activated, and the **Collector Name** will be set as the collector host.

Installing Domotz Collector Progress

1. The setup interface for Domotz Collector is open, displaying a section titled "Installing Domotz Collector" with a progress indicator showing that installation is in progress.

2. Below, a green progress bar visually represents the ongoing activation of the Domotz Collector.

3. A text area provides a log of the installation steps:
   - Uninstaller created at "C:\Program Files (x86)\domotz\uninstall.exe".
   - Npcap installation initiated due to absence.
   - Various executable commands related to installation are shown, including "Visual C++ Redistributables" and Windows Service setup.

4. Navigation buttons at the bottom, "Back" and "Cancel," are currently inactive, indicating that these actions cannot be performed at this stage.

If the installer does not automatically activate the collector, **please open your preferred browser and go to http://127.0.0.1:3000**. It will ask you to log in with your Domotz Account and will guide you to an activation wizard.

Set Up Your Domotz Collector

1. Enter a name for your Collector in the "Collector Name" field to easily identify it later.

2. Click the "Activate Now for Free" button to start monitoring your network. This offers activation free of charge instead of the usual $35/month.

3. If you have a Domotz Voucher, click "Redeem it" to apply the voucher to your account.

4. To replace an existing Domotz Collector on the network, select "Start the migration."

At this point the Domotz Collector will start scanning your network.

If you see an orange bar at the top of your screen after activating your Collector, the Collector is having trouble connecting to the Domotz Cloud.
The services that are failing to connect are listed under **Collector > Discovery**:

Domotz Collector Dashboard with Connectivity Issue Notification

1. The dashboard displays the "HQ Collector" as online with IP details at the top.
2. A warning message indicates limited Domotz Collector capabilities due to firewall settings, with a link to the troubleshooting guide.
3. The left panel shows navigation options, with "Discovery" highlighted. Other options include Basic Information, Default Credentials, Monitoring Configuration, Support, Integrations, and Other Settings.
4. In the main Discovery section, an issue is reported about limited outbound connectivity due to firewall restrictions. Instructions to allow connections to specific hosts and ports are detailed:
   - Host: messaging-us-east-1-cell-1.domotz.com, Port: 5671, Purpose: Remote Management
   - Host: us-west-2-sshg.domotz.co, Purpose: Remote Connection
5. A "Check Again" button is available to retry connectivity status.
6. At the bottom, statistics are shown: 61 Discovered Devices, 2 Subnets Scanned, 0 VLANs Detected, with "Connectivity Issues" indicated in the Collector Status.

To ensure continuous and accurate monitoring, please review this article: [https://help.domotz.com/tips-tricks/unblock-outgoing-connections-on-firewall/](https://help.domotz.com/tips-tricks/unblock-outgoing-connections-on-firewall/)

## **3 Configuring the Domotz Collector**

### **3.1 Device Discovery**

Upon activation, the Domotz Collector will begin its initial scan of the networks associated with its host. Please wait a few minutes for the initial scan to complete. The time needed for each scan varies depending on the size of the network and the number of devices on that network.

Domotz Dashboard Overview

1. In the sidebar, select "Discovery" under the "Collectors" section. This displays the Discovery dashboard, showing device discovery statistics.

2. The top panel shows:
   - "Discovered Devices": 61
   - "Subnets Scanned": 2
   - "VLANs Detected": 0
   - "Collector Status": Healthy, with Auto Discovery turned on.

3. The "Discovered Devices" section provides a breakdown:
   - View devices by "Type" or "Make."

4. Infrastructure and Endpoints are displayed with bar graphs:
   - Infrastructure: 1 Router, 6 Network devices.
   - Endpoints: Various categories such as 4 Desktops, 4 TVs, and 20 Others.

5. The "Show more" option expands the list for further details.

### **3.1.1 Per Location Model**

All discovered devices are automatically managed. With the per-location model, you don't need to add or remove devices from the managed list. This is the default model for new accounts. If you'd like to use the per-device model instead, reach out to our [sales team](mailto:sales@domotz.com), and we'll enable it for you.

### **3.1.2 Per Device Model**

During the trial period - and only during the trial period - all discovered devices are automatically added as managed devices. Once the trial period ends, any new Collector or newly discovered devices will not be added as managed devices automatically. You will be able to manually choose which devices you want to manage.

To select devices for monitoring, navigate the Collector Settings menu, under the Monitoring Configuration, click on the edit icon:

Monitoring Configuration Settings in Software Interface

1. In the "Basic Information" section, you can add or edit the Collector Name, Location, Time Zone, Customer Info, Contract, and Organization details.
2. Under "Default Credentials," you can manage SNMP Authentication, including the version and access settings.
3. The "Ticketing System" section shows no integration, but offers options to link various ticketing services.
4. In the "Monitoring Configuration" section, set devices to manual monitoring by selecting "Custom Selection Mode."
5. Manage monitoring networks and view attached networks.
6. Add external hosts and logical devices to the network in the "Additional Devices" option.
7. "Booster Packs" explains how to increase monitoring limits and displays limits for Managed Devices and Configuration Management Devices.
8. The "Access Management" section allows configuring team access and permissions.

Use these sections to configure and manage your network monitoring preferences.

Here, you'll see all discovered devices listed under the Discovered Devices section. Select the devices you intend to monitor and click Add. The selected devices will then move to the Managed Devices section:

Select Devices to Manage in Monitoring Software

1. In the left sidebar, navigate to "Sites Explorer" and click on "Devices" to view the list of device categories.
2. In the "Devices Explorer" section, select "All Devices" to display a list of available network and specific devices.
3. After selecting the desired devices from the "All Devices" list, click on "Add Devices" located on the right to move them to the "Managed Devices" list for configuration.

Managing Devices in a Network Monitoring System

1. In the navigation pane on the left, expand "Devices" under the "Site Explorer" section.
2. Select "All Devices" to view all available devices, including physical and virtual networks.
3. Under "Physical and Virtual Networks," see the list and count of networks and devices.
4. To manage a device, select it from the "Discovered Devices" column.
5. Use the "Select All" option to bulk manage devices.
6. Move devices to "Managed Devices" by selecting them and using the right arrow button.
7. In the "Managed Devices" section, view detailed information about each device, including name, discovery time, and manufacturer.
8. Use the search filters to find specific devices quickly in both columns.

You can add or remove managed devices at any time to adjust your monitored devices list.

### **3.2 Setting up SNMP on Network Managed Switches**

In order to be able to view your site Network Topology map, you need to enable SNMP on all your managed switches.

Each brand/model has a specific way to set this up, but it is normally done through the device's web-based graphic user interface, or from the command line.

Note: If you do not have local access to the managed switch configuration interface, you may be able to use [Domotz Remote connections](https://help.domotz.com/user-guide/remote-connection-https-rdp-telnet-ssh-tcp-tunnels/) to connect to each device (using HTTP or SSH) in order to configure them.

**Important note:** By default, Domotz will try to use SNMP v2c with "Public/Private" as the community strings. If you used SNMP v1, v3 or have configured custom community strings, please see here how to add it to Domotz:
[https://help.domotz.com/tips-tricks/how-to-set-custom-snmp-credentials-in-domotz/](https://help.domotz.com/tips-tricks/how-to-set-custom-snmp-credentials-in-domotz/)

### **3.3 View Topology Map**

Domotz builds your Network Topology Map from your managed switches. For this to work, enable SNMP on each managed switch. Domotz can then map switches that are either:

- RFC4188 compliant
- LLDP/CDP compliant

We also support mapping via Cloud and Local Integrations with:

- [Cisco Meraki Cloud](https://help.domotz.com/integrations/cisco-meraki-hardware-integration/)
- [Ubiquiti UniFi Controller](https://help.domotz.com/integrations/ubiquiti-unifi-integration/)
- [Ubiquiti UISP Cloud Console](https://help.domotz.com/integrations/ubiquiti-uisp-cloud-console-integration/)
- Fortilink Devices (requires **SNMP data** from the FortiGate and **SSH Device Management unlocked** on the FortiSwitches)

Once the data is available, Domotz creates your site's Network Topology Map. This can take several hours depending on the complexity of the network.

Network topology diagram of connected devices in a software interface.

1. The diagram displays a hierarchical structure starting with an "Internet" node at the top.
2. Directly beneath, "R0 - UDM PRO" and "Zmabade Brasil" are listed, indicating connections to the Internet. "R0 - UDM PRO" and "Zmabade Brasil" provide IP, MAC details, and are linked to switches.
3. The next level shows "SW10 - Main PoE," connected to "R0 - UDM PRO."
4. Below, "SW10 - Main PoE" connects to various devices, including: "SW1 - L… om Top" with 3 devices, "AP1 - Rea…s Room" with 17 devices, "AP0 - Closet" with 9 devices, and "UPSTower."
5. "SW1 - L… om Top" links further to "SW2 - Liv. Bottom" and additional devices.
6. A mini-map on the right provides a visual overview of the network layout with options to toggle link types like Direct, Manual, and Wireless. The Live Topology status is enabled.

Use this topology view to trace device connections and manage the network.

For more information on Domotz Network Topology, see this Knowledge Base article:
[https://help.domotz.com/user-guide/network-topology/](https://help.domotz.com/user-guide/network-topology/)

### **3.4 Switch Port Traffic and PoE Capabilities**

Also, using SNMP data, Domotz can collect detailed information on each port within the managed switch, so you can monitor the site's network traffic:

Interface Information Summary

1. The interface is identified as "GigabitEthernet1 (WAP)."
2. A bandwidth graph displays data usage over time, with blue lines indicating inbound and outbound traffic measured in Mb/s. The visible time frame is from June 8 to July 6, 2026.
3. Options to filter the display are available for Bandwidth, Errors, and Discarded data.
4. Zoom settings can adjust the graph to show data for 1 day (1D), 7 days (7D), or 1 month (1M), with the current view set to 1 month.
5. The interface status section indicates connection via "Stack 1 - Port 1" with Power over Ethernet (PoE) status on.
6. Technical details include:
   - Maximum data rate: 1 Gb/s.
   - PoE consumption: 9W, which is 5% of capacity.
   - Current inbound traffic: 30.7 Kb/s.

And, if you are using a PoE Switch, you will be able to monitor and control power to each port:

Managing PoE Settings on a Network Switch

1. Locate the "Interfaces" tab in the menu to view the connected devices and their details.

2. Check the "Total PoE Consumption" to monitor the current usage, displayed as 13W (7.0% of 185W total capacity).

3. Under "Stack 1," find the list of connected ports with corresponding interface names such as "AP1 - Main," "minis-forum.lan," and "Domotz Draper LG 65''."

4. Each entry shows the network speed and PoE status. For instance, "AP1 - Main" is using 9W PoE power.

5. To adjust PoE settings, look for the toggle switches next to each device. The green status indicates the PoE is active.

6. Options on the right side allow further actions like applying profiles, creating device profiles, managing automation and drivers, exporting or importing settings, and deleting devices.

### **3.5 SNMP Pre-configured Sensors**

Enabling SNMP on other types of devices, such as Printers, NAS, and UPS will allow you to apply Domotz Pre-configured sensors on them to monitor them.

You will find the pre-configured sensors available under the SNMP tab within each device as appropriate.

Printer SNMP Configuration and Supply Levels

1. The top section displays the printer status and network information, showing the printer is online with its IP address and MAC address.
2. The navigation menu includes tabs: Info, Connect, Alerts, History, SNMP, TCP, Interfaces, and Sensor. The SNMP tab is active.
3. Inside the SNMP Monitoring section, the status reads "READ," with authentication set to "V2" and the agent's sample time set to 5 minutes.
4. Options are available to add pre-configured SNMP sensors and add sensors to specific OIDs, with the number of discovered MIBs indicated.
5. The Printer Supplies Table lists four cartridges with their supply levels: Black Cartridge HP W2110X at 32%, Cyan Cartridge HP W2111X at 36%, Magenta Cartridge HP W2113X at 47%, and Yellow Cartridge HP W2112X at 43%.
6. A "Download CSV" link is available for exporting the supply data.

Please see this article for further information on this subject: [https://help.domotz.com/user-guide/pre-configured-snmp-sensors/](https://help.domotz.com/user-guide/pre-configured-snmp-sensors/)

### **3.6 Setting up your Domotz Alerts**

One of the main reasons to onboard Domotz is to receive notifications (alerts) when something on your network is not working as expected. Domotz handles this through Unified Alerts, described below.

Domotz's **Unified Alerts** brings all of your alert configuration into one consistent, centralized experience across every device, collector, and event type.

With **Unified Alerts** you can:

- Manage alert rules for devices, collectors, and device instances (such as ports and disks) from a single interface, at the account, collector, and device level.
- Configure alert types that were previously fixed, including Controller Integration failures, Configuration Backup failures, and Custom Driver failures.
- Use standardized severity levels (Critical, High, Medium, Low) to prioritize response consistently across all alerts.
- Apply alert rules in bulk across many devices, and include them in Device Profiles so they roll out automatically to any device the profile is assigned to.
- See open and resolved alerts directly inside Domotz with **Active Alerts & History**, filter by severity and time, and act without leaving the product.
- Use Mobile Push Notification as a contact channel, alongside email, webhooks, ConnectWise, Halo PSA, Autotask, **etc.**

For a full overview and configuration details, see: [Unified Alerts](https://help.domotz.com/monitoring-management/domotz-unified-alerting/)

### **3.7 Monitoring your Domotz Collector**

When you activate your first collector, you must configure alerts to get notifications about network events. Navigate to the **[Webapp](https://portal.domotz.com/webapp/)**> **Collectors**> **Select your Collector** and open the **Alerts**tab:

Managing Alerts in the Domotz Software.

1. Navigate to the "Alerts" tab in the top menu to access the alerts notification section.
2. Ensure alerts are enabled by checking the toggle switch in the top right.
3. Choose between "Network" and "Devices" alerts using the tabs provided.
4. The summary bar displays the total number of alerts and categorizes them as "All," "With Alerts," and "Without Alerts."
5. Use the search bar to filter metrics and events.
6. The "Connectivity" section allows you to monitor the "Collector Status."
7. In "Network Configuration," manage alerts for "LAN DHCP," "LAN DNS," "LAN Gateway," and "WAN ISP."
8. The "Security" section includes alerts for "New Device Discovery," "TCP Open Port," and "UPnP Port Forwarding."
9. Check "Monitoring Service Health" for overall system health alerts.

Click on **Collector Status** (under **Connectivity**) and assign the rule called "**Collector Status went down**":

Setting an Alert Rule on Collector Status

1. Open the "Alert Rules List" panel.
2. In the section titled "Set an Alert Rule on Collector Status," locate the "Search for Alerts" input to refine your search.
3. Find "Collector Status" with the status indicator "went down."
4. Check the checkbox next to "Collector Status" to select it.
5. The view also shows that "1 Collector" is linked to this alert.
6. To create a new alert from scratch, click on "Configure new Alert."

Now if the collector is down for any reason you will be notified. To add and or remove contact channels from that alert rule, hover your mouse over the Collector Status Alert rule and edit it:

Collector Status Update Interface

1. The interface displays the "Collector Status" section, indicating that the collector status has "went down."
2. A checkmark box is visible, possibly to select or acknowledge the information.
3. A pencil icon is located in the top right corner, suggesting the option to edit or modify the status.
4. An email icon may indicate the option to receive notifications or alerts related to the collector status.
5. Text stating "1 Collector linked" appears, possibly indicating the number of collectors connected to this status.

Inside the alert rule detail, you can edit the alert settings as you prefer; the same rule can be used with any number of collectors in the future:

Alert Rule Configuration Guide

1. The alert is titled "Collector Status." It is set to trigger when the status goes down, with one collector linked.

2. Ensure the "Enable Alert Rule" toggle is turned on (green).

3. Under "Target," select the entity "Collector" and the datapoint "Collector Status" from the dropdown menus.

4. In "Trigger Definition," set the condition to "Is Down" and the severity to "Info."

5. For "Notification Channels," click "Add Channels" to include new channels. An email address is already added and can be removed by clicking the red 'X.'

6. Save changes by clicking "Save and Apply." Alternatively, use "Cancel" to discard changes. Additional options at the bottom include "Clone" and "Delete."

Repeat the same for the other **Network**events:

- **Network Configuration**  - LAN DHCP - LAN DNS - LAN Gateway - WAN ISP
- **Security**  - New Device Discovery - TCP Open Port - UPnP Port Forwarding

The **Collector Status** event is an indication that the Domotz Collector on the Local Area Network is no longer communicating with the Domotz cloud service. Therefore, this is a **must-have alert** if you want to be notified if at least one of the following events happen:
- Issues at the ISP level
- Modem issue
- Router issue
- DNS issue (e.g. the Domotz Collector is not able to resolve Domotz cloud endpoints anymore)
- Issues on the hardware hosting the Domotz Collector
If the Domotz Collector is unable to communicate with the Domotz Cloud (the Collector is marked as **DOWN**), the device status is shown only as a snapshot and **device-level alerts will not be triggered**. This happens because the device status cannot be reported to the Cloud, preventing event notifications from being generated.

For more details about **Network Alerts**, please refer to this article: [**Network Alerts**](https://help.domotz.com/monitoring-management/network-alerts/).

### **3.8 Monitoring a Specific Device**

Same as the alerts for the collector/network level, you need to enable the Alert Rules for your devices for which you want to get notifications.

This device's Alert Rules include the following event alerts:

- **Connectivity**  - Device Status - Heartbeat Lost - IP Address - Ping RTD Median Latency - Ping RTD Packet Loss
- **SNMP Sensors**
- **TCP Ports**
- **Monitoring Service Health**  - Device Configuration Change - Device Configuration Misalignment

Router Management Interface Overview

1. The interface shows a router labeled "R0 - Router" with the status "online" and an IP address of 192.168.86.1, and it provides options to edit and access the manager.

2. Navigation tabs include Info, Connect, Alerts, History, SNMP, and TCP. Select Alerts to view current alerts.

3. The alerts summary section shows a total of 12 alerts: 0 with alerts and 12 without alerts.

4. Use the search bar to query metrics and events.

5. The Connectivity section lists metrics like Device Status, Heartbeat Lost, IP Address, Ping RTD Median Latency, and Ping RTD Packet Loss.

6. SNMP Sensors and TCP Ports sections are available; currently, SNMP Sensors shows 0.

7. The Monitoring Service Health section includes options for Device Configuration Change and Device Configuration Misalignment.

Navigate to the **[Webapp](https://portal.domotz.com/webapp/)**> **Collectors**> **Select your Collector** > **Alerts**tab and open the **Devices** section:

Managing Device Alerts in Domotz

1. Navigate to the "Alerts" tab in the main menu at the top of the screen.
2. Under "Collector Alerts Notification," switch to the "Devices" tab to view device-specific alerts.
3. The table lists devices by name, type, make/model, IP/MAC address, tags, and alert rules.
4. To configure alerts for a device, locate the "Alert Rules" column and click "Add" next to the desired device.
5. Use the search bar to filter devices by name if needed.

At the **Alert Rules** column, click on **Add** next to the device you want to enable event alerts:

Adding Alert Rules for a Router Device

1. Locate the device named "R0 - Router" in the Device Name column.
2. Verify the device type, shown as Cisco, under Make | Model.
3. Check the IP and MAC Address fields: IP is 192.168.66.1, and MAC is 0C:EA:14:51:C9:BD.
4. To add alert rules, click the "Add" link under the Alert Rules column next to the desired device.

Select one of the events, for example, the **Device Status**:

Device Details Interface Overview

1. The top section indicates the device name as "R0 - Router," its status as "online" with IP address "192.168.86.1," and is associated with "@HQ Collector."
2. Below the device information, various action buttons are available, including "Access Manager," "Info," "Connect," "Alerts," "History," "SNMP," and "TCP."
3. The search bar allows searching for metrics and data with filters set to show "12 All," "0 With Alerts," and "12 Without Alerts."
4. Under the "Connectivity" section, key options include "Device Status," "Heartbeat Lost," "IP Address," "Ping RTD Median Latency," and "Ping RTD Packet Loss."
5. Sections for "SNMP Sensors," "TCP Ports," and "Monitoring Service Health" are present with numeric indicators showing the number of items or alerts under each category.

Enable the rule **Device Status went down**:

Configure an Alert Rule for Device Status

1. In the "Alert Rules List" panel, locate the section titled "Set an Alert Rule on Device Status".
2. Use the search bar labeled "Search for Alerts" if needed, to find specific alerts.
3. Ensure the "Status" option is checked to enable alerts for when "Device Status went down".
4. Note that the alert is linked to one device, indicated by "1 Device linked".
5. Select "Configure new Alert" to set up additional alerts as needed.

Now, if the device is down for any reason, you will be notified. To add and/or remove contact channels from that alert rule, hover your mouse over the Device Status Alert rule and edit it:

Status Notification Settings Panel

1. The panel shows a "Status" label indicating the current device state.
2. The text "Device Status went down" is displayed, signifying that the device is currently offline.
3. A checkmark icon signifies that this status notification is active.
4. To edit this status notification, select the pencil icon located on the right side of the panel.

Inside the alert rule detail, you can edit the alert settings as you prefer; the same rule can be used with any number of collectors in the future:

Alert Rule Configuration Interface

1. Review the alert rule status, showing "Device Status went down" with 1 device linked.
2. Enter the Alert Name under "Alert Name*."
3. Toggle "Enable Alert Rule" to activate or deactivate the alert.
4. Under "Target*," select the Entity and the corresponding Datapoint for the alert.
5. In "Trigger Definition*," choose the Condition ("Is Down") and the Severity level ("Info").
6. In "Notification Channels," click "Add Channels" to specify how notifications will be sent. An example email is shown: "henrique+guide@domotz.com."
7. Use the "Back" button to exit without saving or "Save and Apply" to save changes.
8. Options for cloning or deleting the alert rule are available at the bottom.

Repeat the same for the other **Device**events.

For more details about **Device Alerts**, please refer to this article: [**Device Alerts**](https://help.domotz.com/monitoring-management/device-alerts/).

### **3.9 Creating a Remote Connection**

Finally, it is worth mentioning that you can remotely connect to all discovered devices in your network that expose at least one open port (service) to which you can connect.

For simplicity, we will focus on making a simple, direct connection to a device's webpage.

To see the list of those, enter the "Remote Access" section:

Accessing Remote Access in the Software Interface

1. Navigate to the top menu bar in the software interface.
2. Select the "Remote Access" tab among the main options, which include Devices, Topology, Alerts, Connectivity, Security, and Reports & Logging.
3. Once in the "Remote Access" section, you will see three options: Connections, VPN, and History.
4. Use these options to manage and view remote access activities within the software.

From this view you will be able to get a list of the available devices to which you can connect to, and also to search for the service you might need, based on service protocol or device properties (Name, IP Address, MAC Address, Model, Location, and Zone):

Remote Connection to a Device Guide

1. Navigate to the "Remote Access" tab in the top navigation menu.
2. Under "Remote Connection to a Device," click "New Connection."
3. Use the search bar labeled "Filter by device properties or protocol" to find the desired device.
4. Identify the device you wish to connect to and note its connection details, such as uptime and protocol.
5. Click the "Connect" button next to the chosen device to establish a remote connection.
6. Additional options include creating a custom connection or opening a TCP tunnel, accessible via the buttons below the device list.

And after clicking on the "Connect" button you'll be redirected to the device login (in this case a web interface, since we clicked on port 80 of this Toshiba printer):

Toshiba B-EX Web Utility Login Page

1. On the left side, there are menu options for different functions: Maintenance, Download, Parameter Setting, Tool, Z Mode, and D Mode. Each option can be expanded for more functions.
2. On the right side is the login panel for the Toshiba B-EX Printer Web Utility.
3. Enter your credentials in the "Username" and "Password" fields.
4. A message prompts you to ensure both fields are filled in.
5. Click the "Login" button to proceed.

For more information about Remote Connections you might check this Knowledge Base article:
[https://help.domotz.com/user-guide/remote-connection-https-rdp-telnet-ssh-tcp-tunnels/](https://help.domotz.com/user-guide/remote-connection-https-rdp-telnet-ssh-tcp-tunnels/)

### **3.10 AI Agents**

Connect ChatGPT, Claude or other AI Agent that supports MCP servers to the Domotz MCP server (https://mcp.domotz.com/mcp) to let it operate your fleet.

When using tokens, treat them like a password. Anyone with the key can access your Domotz data within your account permissions. Revoke it any time from the MCP API keys page.

### **3.10.1 ChatGPT**

Connect ChatGPT to the Domotz MCP server

1. ChatGPT (Apps)  - Open Apps (left menu or Settings → Apps) and search for "Domotz" — it is available as a pre-approved app. Open it, click Connect → Sign in with Domotz, then approve access. No key to copy.
2. Codex / clients using a bearer token  - For Codex or any client that cannot open an interactive login, generate an MCP API key and send it as a Bearer token in the Authorization header. Navigate to the **[Webapp](https://portal.domotz.com/webapp/)**> Account > **Domotz MCP API** > **Create MCP API Key**.

```
{
  "mcpServers": {
    "domotz": {
      "url": "https://mcp.domotz.com/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_MCP_API_KEY>"
      }
    }
  }
}
```

### **3.10.2 Claude**

Connect Claude to the Domotz MCP server

1. Claude.ai (Pro plan or higher)  - Open Customize → Connectors → Add custom connector. Enter the name "Domotz" and the server URL https://mcp.domotz.com/mcp, then click Add and Connect. A Domotz login window opens — sign in and approve access.
2. Claude Code (CLI) — sign in with OAuth  - Run the command below, then run /mcp inside Claude Code to complete the browser sign-in. Use --scope user to enable it for every session:  - `claude mcp add --transport http --scope user domotz https://mcp.domotz.com/mcp`
3. Claude Code (CLI) — or use a bearer token  - Navigate to the **[Webapp](https://portal.domotz.com/webapp/)**> Account > **Domotz MCP API** > **Create MCP API Key**. - pass it directly on the command line:

```
claude mcp add --transport http --scope user domotz https://mcp.domotz.com/mcp \
  --header "Authorization: Bearer <YOUR_MCP_API_KEY>"
```

### **3.10.3 Other Clients**

Any MCP-capable client can connect to the Domotz MCP server (https://mcp.domotz.com/mcp) with a bearer token.

1. Navigate to the **[Webapp](https://portal.domotz.com/webapp/)**> Account > **Domotz MCP API** > **Create MCP API Key**.

```
{
  "mcpServers": {
    "domotz": {
      "url": "https://mcp.domotz.com/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_MCP_API_KEY>"
      }
    }
  }
}
```

### **3.10.4 Use Natural Language to Manage your Networks**

Once you have your AI Agent connected to the Domotz MCP server, you can start using natural language and leveraging AI to assist you with hints:

Device Status Overview

1. Critical and important devices in the home network and infrastructure are all online. This includes:
   - Critical-tagged devices: UDM Pro router, both switches, and access points (APs).
   - Important-tagged devices: Hazemaze NAS, Proxmox boxes, cameras, PDUs, thermostats, AdGuard, Home Assistant, and Landscape server.

2. All collectors in Draper Office, São Paulo, and Home are online.

3. Devices showing as down include typical offline suspects like phones, tablets, smartwatches, and laptops that may roam or sleep off Wi-Fi. None of these are tagged as important or critical.

4. A Minis-Forum-Windows collector has been offline since July 2025. It's flagged for review in case it needs to be retired or fixed, although it is not an immediate concern.

You can easily generate reports:

Connectivity Report for Collectors

1. A command to "Generate a report on the connectivity status of all my collectors" is shown.
2. The report states there are 7 collectors in total.
3. 6 collectors are online and healthy.
4. "Minis-Forum-Windows" has been offline since July 24, 2025, despite being on an active paid subscription that expires at the end of 2026.
5. Consider reviving or deactivating this license due to the extended offline status.

Domotz Collector Connectivity Report Overview

1. Summary: Out of 7 total collectors, 6 are online, and 1 is offline. The offline collector is Minis-Forum-Windows, inactive since July 24, 2025, and needs attention.

2. Collector Details:
   - BistroVista-Draper office: Online, last status change on March 30, 2026. Organization: BistroVista. IP: [googelfiber.net]. Agent version: 8.7.2-b001. Timezone: Europe/London.
   - 003-Draper Office (Windows Agent): Online, last status change on April 16, 2026. Organization: Domotz Inc. IP: [googelfiber.net]. Agent version: 8.7.2-b001. Timezone: America/Denver.
   - 000-Home: Online, last status change on April 24, 2026. Organization: Personal. IP: [utopiafiber.com]. Agent version: 8.7.3-b001. Timezone: America/Denver.
   - 004-Draper Office (Netgear Agent PR460X Router): Online, last status change on March 30, 2026. Organization: Domotz Inc. IP: [googelfiber.net]. Agent version: 6.6.7-b001. Timezone: America/Denver.
   - Minis-Forum-Windows: Offline since July 24, 2025. No organization listed. IP: [googelfiber.net]. Agent version: 7.4.5-b001. Timezone: America/Denver.

And much more.

We hope the Domotz Onboarding Guide was useful. Learn more about Domotz on the [website](https://www.domotz.com) and [our blog](https://blog.domotz.com).

If you have any questions or need assistance, the Support team will always be happy to help at [support@domotz.com](mailto:support@domotz.com)!