# Controlling Device Discovery with Forced IP Range and Forced IP List

**Note:** The IP Ranges and IP Lists settings on this page are primarily aimed at controlling which addresses Domotz scans _within_ your existing network. They are not the recommended way to add additional subnets to discovery. If you need to monitor devices on other subnets, see [Adding VLAN Interfaces](https://help.domotz.com/tips-tricks/vlan-network-interface-configuration/), [Routed Subnets (Layer 3)](https://help.domotz.com/monitoring-management/routed-network/), or [External Hosts](https://help.domotz.com/monitoring-management/automated-discovery-inventory/#2) instead.

## Overview

By default, Domotz automatically discovers all devices within the broadcast domain of the network your collector is deployed on. This works well in most environments, but there are situations where you may want more control, for example, if you're working on a large flat network and only need to monitor a specific subnet, or if you want to exclude certain IP ranges from discovery entirely.

Domotz gives you two ways to do this: Forced IP Range and Forced IP List. Both options require you to first disable auto-discovery, after which the agent will only scan the addresses you explicitly define.

**Forced IP Range** lets you define a contiguous block of IP addresses for the agent to scan. This is useful when you want to target a specific subnet or address range.

**Forced IP List** lets you specify individual IP addresses. This is useful when you only need to monitor a handful of known devices rather than an entire range.

**Note on account types:** If you're on a per-device account, you can configure both options directly from the Domotz UI. If you're on a per-location account, setting the IP scan policy is only available via the Domotz API. However, disabling auto-discovery can be done from the UI regardless of account type.

## Per-Device Accounts: Configuring from the UI

1. Navigate to the **"Collector"** tab from the **Explorer** and select the **Auto Discovery** section.
2. Toggle off **Auto-Discovery** to disable automatic scanning of the full broadcast domain.

Collector Discovery Dashboard Overview

1. Navigate to the top menu and select "Collector."
2. On the left sidebar, click on "Discovery."
3. Review the status panel where "Collector Discovery" is detailed, indicating that discovery checks occur every 30 seconds.
4. Note the "Auto Discovery" toggle on the right, which is set to "On."
5. Observe the "Initial Discovery Complete" message confirming that network data collection will continue.
6. Learn about deeper discovery benefits such as network reachability, IP and device discovery, device identification, and protocol testing.
7. Access more information or actions via "View Device List" and "How Domotz Works" buttons.
8. View key metrics at the bottom: 14 discovered devices, 3 subnets scanned, 1 VLAN detected, and 100% SNMP authenticated.

1. To set a Forced IP Range, navigate to your **Device List**
2. Select the "+" next to the **IP Address Range** section of the sidebar on the left
3. Enter the start and end IP addresses of the range you want the collector to scan.

Accessing and Configuring Devices in the Network Setup

1. Navigate to the "Devices" tab in the top menu bar to manage network devices.

2. In the left sidebar, under "Setup Review," you can review "VLAN Configuration" and "Configuration Management" settings.

3. Click on "Network Configuration" to expand the list of network setup options.

4. Under "All Devices," view physical networks, VLANs, routed networks, and IP address configurations. Expand each section for detailed device and network information.

5. To add a new IP address range, select "IP Address Range" and click the plus (+) icon.

6. The main section displays devices divided by type: Wi-Fi, POE Switch, Server, and Virtual Machine. Each device shows details such as name, uptime in minutes, and IP address.

7. For additional sorting, use the “Group” and “Sort” dropdowns in the upper-right to organize devices by various criteria.

Use this panel to configure and monitor all devices connected to your network effectively.

1. To set a Forced IP List, navigate to your **Device List**
2. Select the "+" next to the **IP Address List** section of the sidebar on the left
3. Enter the list of IP addresses you want the collector to scan.

Navigating the Devices Section in Network Configuration

1. Access the "Devices" tab in the top navigation menu to manage network devices.
2. Use the left sidebar to explore various configuration options: "Setup Review," "Network Configuration," and "All Devices."
3. Under "All Devices," review your network setup including "Physical Networks," "VLANs," "Routed Networks," and "External Hosts."
4. To manage IP addresses, click on "IP Address List" in the sidebar. Click the plus icon beside it to add new entries.
5. The main panel displays a summary of devices with statuses such as "Total," "Online," and "Offline," with details like device type and IP addresses.
6. Use the filters at the top right to organize devices by different criteria such as "Type" and "IP Address."

## Per-Location Accounts: Configuring via the API

Before making any API calls you'll need your **API key** and the **Agent ID** for the agent you want to configure. Both are available from your Domotz portal.

   https://help.domotz.com/admin-global-features/domotz-api/

Configuring a forced IP scan is a two-step process: first you disable auto-discovery from the UI, then you define the IPs or ranges you want the agent to scan via the API.

### Step 1 - Disable Auto-Discovery

Navigate to the **"Collector"** tab from the **Explorer** and select the **Auto Discovery** section and toggle off **Auto-Discovery** to disable automatic scanning of the full broadcast domain.

Collector Discovery Dashboard Overview

1. Navigate to the top menu and select "Collector."
2. On the left sidebar, click on "Discovery."
3. Review the status panel where "Collector Discovery" is detailed, indicating that discovery checks occur every 30 seconds.
4. Note the "Auto Discovery" toggle on the right, which is set to "On."
5. Observe the "Initial Discovery Complete" message confirming that network data collection will continue.
6. Learn about deeper discovery benefits such as network reachability, IP and device discovery, device identification, and protocol testing.
7. Access more information or actions via "View Device List" and "How Domotz Works" buttons.
8. View key metrics at the bottom: 14 discovered devices, 3 subnets scanned, 1 VLAN detected, and 100% SNMP authenticated.

Once that's done, proceed to setting your IP scan policy via the API.

### Step 2 - Set Your Forced IP Range, IP List, or Both

1.

Send a PUT request to the IP scan policy endpoint. You can include a forced IP list, a forced IP range, or both in the same request:

```
PUT https://{api_endpoint}/public-api/v1/agent/{agent_id}/network/ip-scan-policy
```

Headers:

```
Content-Type: application/json
X-Api-Key: YOUR_SECRET_TOKEN
```

Request body (range and list together):

```
{
  "forced_ip_addresses": [
    "192.168.1.10",
    "192.168.1.25",
    "192.168.1.50"
  ],
"forced_ip_ranges": [
    {
      "start": "10.0.0.1",
      "end": "10.0.0.100"
    },
    {
      "start": "192.168.1.30",
      "end": "192.168.1.40"
    }
  ]
}
```

To use only a list, leave the body for `forced_ip_ranges` blank.

```
{
  "forced_ip_addresses": [
    "192.168.1.10",
    "192.168.1.25",
    "192.168.1.50"
  ],
  "forced_ip_ranges": [
    {
      "start": "",
      "end": ""
    }
  ]
}
```

To use only a range, leave the body for `forced_ip_addresses` blank.

```
{
  "forced_ip_addresses": [
    ""
  ],
"forced_ip_ranges": [
    {
      "start": "10.0.0.1",
      "end": "10.0.0.100"
    },
    {
      "start": "192.168.1.30",
      "end": "192.168.1.40"
    }
  ]
}
```

### Viewing the Current IP Scan Policy

To check what's currently configured, send a GET request to the same endpoint:

```
GET https://{api_endpoint}/public-api/v1/agent/{agent_id}/network/ip-scan-policy
```

### Reverting to Default

To clear the IP scan policy and return the agent to full auto-discovery, send a DELETE request to the IP scan policy endpoint and re-enable auto-discovery from the UI:

```
DELETE https://{api_endpoint}/public-api/v1/agent/{agent_id}/network/ip-scan-policy
```

## FAQ

**What happens to devices that were already discovered outside my forced range or list?** Devices discovered before you applied these settings will continue to be monitored as normal. They won't be removed automatically. However, if you manually delete one of those devices, it will not be rediscovered since it falls outside your defined range or list.

**Can I use both a Forced IP Range and a Forced IP List at the same time?** Yes. You can include both `forced_ip_ranges` and `forced_ip_addresses` in the same PUT request and they'll work together.

**How do I revert back to full auto-discovery?** Send a DELETE request to the IP scan policy endpoint (per-location accounts) or clear the forced scan settings from the UI (per-device accounts), then re-enable auto-discovery from the UI. This will return the agent to scanning the full broadcast domain.