2.2 KiB
IP Addresses (IPAM)
The IP Address tool provides a central place to store and manage the public IP addresses of your servers, VPSs, and services across different vendors. It also cross-references each IP against your locally cached DNS records to show which domains currently point to it.
Accessing the tool
Navigate to 🖥️ IP Addresses in the sidebar under the Tools section.
IP address fields
| Field | Required | Description |
|---|---|---|
| IP Address | Yes | An IPv4 or IPv6 address. Cannot be changed after creation — delete and re-add if the address changes. |
| Label | No | A friendly name, e.g. Web Server 1 or VPN Gateway |
| Vendor / Provider | No | The hosting provider, e.g. Hetzner, DigitalOcean, AWS |
| Location / Region | No | The server location, e.g. Frankfurt, US-East |
| Notes | No | Any additional free-text notes (shown as an ℹ icon in the table) |
Both IPv4 (shown in blue) and IPv6 (shown in purple) addresses are supported.
DNS cross-reference
The DNS Records column automatically scans the locally cached DNS records and shows any A or AAAA records whose value matches the stored IP address. Each match displays the provider badge and the full domain name.
This makes it easy to see at a glance which domains are pointing to a given server, and to spot IPs that are not referenced by any DNS records.
Note: The cross-reference is based on the local DNS cache. Sync the relevant zones to ensure the data is up to date.
Filtering
Use the filter bar to search across IP address, label, vendor, and location fields simultaneously.
Export
Press ⬇ Export CSV to download the current (filtered) list as a CSV file. The export includes the IP address, label, vendor, location, notes, and the matching DNS records as a semicolon-separated string.
Audit log
All IP address changes (add, update, delete) are recorded in 📋 Audit Log under the category IP Address.
Data storage
IP addresses are stored in backend/ipam.json. This file is created automatically on first use. The path can be overridden with the IPAM_PATH environment variable — see ENVIRONMENT.md for details.