How to display IPAM information of an Incus deployment

IPAM is a method used to plan, track, and manage the information associated with a computer network’s IP address space. In essence, it’s a way of organizing, monitoring, and manipulating the IP space in a network.

Checking the IPAM information for your Incus setup can help you debug networking issues. You can see which IP addresses are used for instances, network interfaces, forwards, and load balancers and use this information to track down where traffic is lost.

To display IPAM information, enter the following command:

incus network list-allocations

By default, this command shows the IPAM information for the default project. You can select a different project with the --project flag, or specify --all-projects to display the information for all projects.

The resulting output will look something like this:

+------------------------+-----------------+----------+------+-------------------+
| USED BY                | ADDRESS         | TYPE     | NAT  | HARDWARE ADDRESS  |
+------------------------+-----------------+----------+------+-------------------+
| /1.0/networks/incusbr0 | 192.0.2.0/24    | network  | true |                   |
+------------------------+-----------------+----------+------+-------------------+
| /1.0/networks/incusbr0 | 2001:db8::/32   | network  | true |                   |
+------------------------+-----------------+----------+------+-------------------+
| /1.0/instances/u1      | 2001:db8::1/128 | instance | true | 00:16:3e:04:f0:95 |
+------------------------+-----------------+----------+------+-------------------+
| /1.0/instances/u1      | 192.0.2.2/32    | instance | true | 00:16:3e:04:f0:95 |
+------------------------+-----------------+----------+------+-------------------+

...

Each listed entry lists the IP address (in CIDR notation) of one of the following Incus entities: network, network-forward, network-load-balancer, and instance. An entry contains an IP address using the CIDR notation. It also contains an Incus resource URI, the type of the entity, whether it is in NAT mode, and the hardware address (only for the instance entity).