How do I add a subnet (IP range)?

Requires Basic

Quick answer

You document a subnet in the Network module, on the IP Ranges tab. Assign a name and enter the network as CIDR (e.g. 10.0.0.0/24). Optionally, you can add a gateway, a VLAN, and a description. The IP range is a documentation unit — it does not automatically generate individual IP addresses.

Prerequisites

Included in all plans from Basic onward.

Open the “IP Ranges” tab. Choose Network and switch to the IP Ranges tab at the top. Click Add.

Screenshot pending netzwerk-subnetz-01 The 'IP Ranges' tab in the Network module with the form for a new IP range

The 'IP Ranges' tab — this is where you add a subnet via CIDR.
Fill in the form. Required:
- Name — a descriptive label, e.g. “Server LAN Munich”
- CIDR — the network in CIDR notation, e.g. 10.0.0.0/24
Optional: Gateway (e.g. 10.0.0.254), VLAN (chosen from your VLANs), and Description.
Save. The range appears in the list. You continue to maintain individual hosts as IP addresses.

Via the REST API: a POST to /api/v1/network/ip-ranges. Required are name and cidr.

curl -X POST https://demo.notory.io/api/v1/network/ip-ranges \
  -H "Authorization: Bearer inv_dein_token" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Server-LAN Muenchen",
    "cidr": "10.0.0.0/24",
    "gateway": "10.0.0.254",
    "description": "Produktives Server-Segment"
  }'

{
  "id": "0190f3a2-7d22-7c9f-a1b3-2d5e6f7a8b91",
  "tenant_id": "3d9b0c12-4e5a-4f88-b1c7-2a9e6d4f0011",
  "name": "Server-LAN Muenchen",
  "cidr": "10.0.0.0/24",
  "gateway": "10.0.0.254",
  "vlan_id": null,
  "description": "Produktives Server-Segment",
  "created_at": "2026-07-08T09:25:00Z",
  "updated_at": "2026-07-08T09:25:00Z"
}

Change it via PUT /api/v1/network/ip-ranges/{id}, delete it via DELETE /api/v1/network/ip-ranges/{id} (administrator).

Possible errors: 401, 403 (permissions/role), 422 (empty name or cidr).

What happens behind the scenes?

Tenant assignment: The range belongs to your current tenant and is isolated.
Documentation only: Notory does not create individual IP addresses for the range and does not calculate utilization. If you want to track hosts, record them as IP addresses and assign them to the same VLAN if applicable.
VLAN reference: If the range references a VLAN and that VLAN is deleted, Notory sets the reference to null (SET NULL) — the range itself remains.
CIDR is stored, not validated or enforced: The field stores the CIDR as text; no collision check is performed against other ranges.