Skip to main content

Inventory

The Inventory page is the central hub for exploring your entire Proxmox infrastructure. It provides a vSphere-like tree view that organizes all your nodes, virtual machines, containers, and resources in a familiar hierarchical layout.

Inventory tree showing Proxmox clusters, nodes, VMs, containers, storage, pools, and tags
The inventory tree gives operators a unified view of clusters, nodes, VMs, containers, storage, pools, and tags.

Split-Pane Layout

The Inventory uses a split-pane interface divided into two panels:

  • Navigation tree (left) -- A hierarchical tree listing your clusters, nodes, VMs, and containers. Click any item to select it.
  • Details panel (right) -- Displays detailed information about the currently selected resource.

A resizable divider separates the two panels. Drag it to adjust the proportions according to your preference.

View Modes

The navigation tree supports multiple view modes, letting you organize resources in the way that makes the most sense for your workflow.

Tree View

The default hierarchical view that mirrors your Proxmox topology:

Cluster
├── node-01
│ ├── vm-100 (web-server)
│ ├── vm-101 (database)
│ └── ct-200 (dns)
├── node-02
│ ├── vm-102 (app-server)
│ └── ct-201 (proxy)
└── node-03
└── vm-103 (monitoring)

Hosts View

Groups all resources by Proxmox node. Useful when you need to see what is running on a specific hypervisor.

Pools View

Groups resources by Proxmox resource pool. Ideal for environments where VMs and containers are organized by project, team, or customer.

In multi-tenant deployments, IaaS tenant resources are represented through tenant-owned vDC pools, so those tenant users only see resources in their assigned pools, while MSP tenants see the pools of the clusters they own. Provider administrators always see the full pool hierarchy.

Tags View

Groups resources by tag. If you use Proxmox tags to classify workloads (e.g., production, staging, database), this view lets you filter by those labels instantly.

Node Details

Selecting a Proxmox node in the tree opens its own set of tabs in the right panel. The Summary tab leads with the host figures, the Disks tab covers the physical hardware underneath.

Node temperatures

Proxmox exposes no temperature of its own, and a stock node has neither lm-sensors nor ipmitool installed. ProxCenter therefore reads the values straight from the kernel, over SSH, out of the hwmon tree that the drivers already publish under /sys/class/hwmon. Nothing is installed on the node.

Each reading is placed next to the figure it explains rather than in a sensors panel of its own, in the first column of the node summary:

FigureTemperature shown next to it
CPU usageThe hottest CPU package or core
RAM usageThe hottest memory module, on hardware whose DIMMs report one
Root FS usageThe hottest drive, NVMe included

ProxCenter recognises the chips by name and files each one under a role, so a reading is never attributed by guesswork: coretemp, k10temp, zenpower and cpu_thermal are CPU, nvme and drivetemp are drives, spd5118 and jc42 are memory modules. Several sensors under the same role are reduced to the highest of them. A chip ProxCenter does not recognise is read but not displayed, rather than being filed under a role it may not belong to.

The value turns amber, then red, on a threshold that belongs to its role, because 55 °C is unremarkable on a CPU and alarming on an SSD:

RoleWarningCritical
CPU80 °C90 °C
Memory75 °C85 °C
Drive50 °C60 °C

Readings outside the plausible range are dropped rather than displayed, and the whole set is cached for a minute per node, so opening a node repeatedly does not mean an SSH session each time.

Requires SSH access on the connection

Temperatures are the one part of the node view that does not come from the Proxmox API. Enable SSH on the connection first, under Settings > Connections, edit the connection, then the SSH Access section: Enable SSH access, a SSH Port, a User, and an Authentication method, either an SSH private key or a password. See Connections.

Without it, or on a node whose kernel publishes no usable sensor, there is simply no temperature next to the figures. The rest of the summary is unaffected, and nothing reports an error: the request answers "not available" rather than failing.

note

The root filesystem bar is labelled Root FS usage on purpose. It is the usage of / on the host, the space Proxmox itself runs on, and it says nothing about your datastores. Storage capacity lives in the Storage views.

Disk health and SMART

The Disks tab lists the physical devices of the node under Physical Disks, with their model, serial, size, type, usage and health, plus a wear indicator for the devices that report one. A device that reports no wear figure shows N/A rather than an empty or full bar.

The health column is a chip that follows what the drive actually said:

Reported healthChip
OK, PASSEDGreen
FAILEDRed
Anything else, UNKNOWN! includedAmber

Amber for the unrecognised case is deliberate. A drive answering something ProxCenter does not know how to read is not a drive in good health, it is a drive whose health is unknown, and painting it green was hiding exactly the devices worth looking at.

Click a disk row to expand its SMART data. Two shapes are handled:

  • Attribute tables, the classic SATA and SAS form: one row per attribute with its ID, name, current value, worst value, threshold and raw value. An attribute whose value has fallen to or below its threshold is flagged.
  • The NVMe text form, which is what real hardware returns through Proxmox. It is parsed into labelled rows instead of being dumped as a block of text, and any line that does not parse is still shown verbatim underneath, so nothing the drive reported is lost.

On the NVMe form, each figure carries the direction it should be read in, which is what makes the colors mean anything:

AttributeDirectionA high value means
Available SpareHigher is betterPlenty of spare blocks left
Percentage UsedHigher is worseEndurance consumed
Everything elseNot classifiedShown neutral, never color-coded as health

Available Spare Threshold is shown as the reference figure it is, without a bar of its own: it is the level at which the drive considers its spare pool exhausted, not a measurement of the drive's state.

A drive that returns nothing usable says so: SMART data is not available for this disk.

ZFS pools

The ZFS sub-tab of the same Disks tab lists the ZFS pools of the node under ZFS Pools, with size, allocated and free space, fragmentation, dedup ratio, health, state and last scrub. The health chip follows the pool: ONLINE green, DEGRADED amber, FAULTED red.

Last scrub carries the pool's own scrub sentence, in red when it reported errors, and reads Never scrubbed for a pool that has never been scrubbed at all, which on a pool holding production guests is a finding in itself.

Expand a pool row to get its vdev tree: each vdev and each device under it, indented as ZFS nests them, with its state and its read, write and checksum error counters. That is where a pool reporting DEGRADED tells you which device to replace.

The LVM, LVM-Thin and Directory sub-tabs sit alongside and cover the other storage layers of the node.

info

The Disks tab and everything in it is reserved for a super_admin. Reading disks and pools goes through node.view on the connection, but the tab itself is not offered to a scoped operator.

VM and Container Details

Selecting a VM or container in the tree opens a detailed view in the right panel with the following information:

SectionDetails
StatusRunning, stopped, paused, or suspended state with a color-coded indicator
CPUCurrent CPU usage, allocated vCPUs, CPU type
MemoryCurrent memory usage, allocated memory, balloon status
DiskDisk size, actual usage, storage backend
NetworkNetwork interfaces, MAC addresses, VLAN tags
IP AddressesIPv4 and IPv6 addresses detected via the QEMU guest agent or LXC network config
Operating SystemOS type and version as reported by the guest agent
UptimeHow long the guest has been running since its last start
SnapshotsList of available snapshots with name, date, and description
Green Score30-day energy, cost, and CO2 estimate for the VM when Green IT data is configured
tip

IP address detection requires the QEMU Guest Agent to be installed and running inside virtual machines. Containers report IP addresses natively.

VM detail view with status, CPU, memory, disk, network, snapshots, and Green Score
The VM detail view brings operational metrics, configuration, snapshots, network data, and Green Score into one panel.

Hardware

The Hardware tab of a guest lists its disks, each with its storage and its format on the secondary line, and its CPU and memory cards above them.

Disk format

The format shown is the one the volume really has. Proxmox removes the optional format= property from the guest configuration as soon as it has allocated the volume, so reading the configuration alone told us nothing and every disk fell back to raw, which mislabelled every qcow2 and every imported vmdk. ProxCenter now derives the format from the volume name, which is where Proxmox keeps it.

A volume with no extension, on LVM, RBD or a ZFS zvol, is still reported as raw, because that is genuinely what it is.

The formats a storage will accept are read from the cluster storage configuration rather than deduced from the storage type. Since Proxmox VE 9 the type is no longer the answer: an LVM storage with volume-chain snapshots enabled takes qcow2 too. The Add disk, Edit disk, Clone and Create VM dialogs all offer what the storage actually accepts, and the edit dialog defaults to Keep the current format rather than silently converting anything.

The Cloud-Init drive

A Cloud-Init drive is declared in the guest configuration as a CD-ROM entry, but unlike an ISO mount it is backed by a real volume that Proxmox generates and owns. It used to appear in the list as an ordinary CD-ROM, which was misleading on a block storage and, worse, offered the ISO editor on it: changing the "mounted image" would have detached the volume.

It now carries its own Cloud-Init chip and its own icon, in the disk list and in the boot order, and the row is informative only: no edit action, no disk action menu.

Changing CPU or memory

Set the new value in the CPU or Memory (RAM) card and click Save memory changes, or its CPU equivalent.

Removing memory from a running guest is slow by construction: Proxmox unplugs one DIMM at a time and pauses 3 seconds per module, so taking a running guest from 8G to 4G costs around 24 seconds at best. That used to outlive the request and reported a failed save, while Proxmox went on applying the change perfectly well.

Guest configuration writes now follow the Proxmox task instead of waiting on a single request. If the task takes longer than the budget, ProxCenter says Proxmox is still applying the change, please wait. and keeps following it, rather than declaring a failure that did not happen. A slow write also no longer counts against the health of the connection: a node that is busy is not a node that is unreachable.

The confirmation then reports what Proxmox itself says is pending, rather than guessing from the power state:

What Proxmox reportsWhat you see
The change is liveChanges have been applied successfully.
The change is pendingThe VM is running. RAM changes take effect once the VM has been stopped and started again. The Reboot action does that, a reboot issued from inside the guest does not.

That distinction matters: a hotplugged change now reads as applied instead of always claiming a restart is needed, and a change that really is pending names the operation that will apply it. A reboot ordered from inside the guest does not, because the QEMU process is never recreated.

LXC Network Editing

For containers, the network edit dialog supports IPv4, gateway, IPv6, and interface fields. This allows operators to update LXC network configuration without leaving ProxCenter.

In tenant vDCs, network edits are validated against the tenant's allowed bridges, VNets, subnets, and IPAM reservations.

Search and Filtering

A search bar at the top of the navigation tree lets you quickly find resources by name, VMID, or IP address. Results are filtered in real time as you type.

You can also apply filters to narrow down the tree:

  • By status -- Show only running, stopped, or all resources
  • By type -- Show only VMs, only containers, or both
  • By node -- Limit results to a specific Proxmox node

Favorites

Mark frequently accessed VMs, containers, or nodes as favorites for quick access. Favorited resources appear in a dedicated section at the top of the navigation tree, so you can reach them without scrolling through the full hierarchy.

To add a favorite, right-click a resource and select Add to Favorites, or click the star icon next to its name.

Migration Detection

ProxCenter monitors your Proxmox cluster in real time and automatically detects ongoing VM migrations. When a migration is in progress:

  • The migrating VM displays an animated indicator in the tree
  • The details panel shows the source and destination nodes
  • The migration progress is updated in real time until completion
info

Migration detection works for both online and offline migrations initiated from ProxCenter or directly from the Proxmox API.

Green Score

When datacenter factors are configured, the VM header displays a Green Score summarizing the last 30 days of estimated energy, cost, and CO2 impact. Hover the score to view the calculation context:

  • CPU average
  • Datacenter PUE
  • Energy, cost, and CO2 deltas
  • One actionable insight, such as idle CPU, oversized RAM, mostly stopped workload, or efficient datacenter placement

See Datacenters & Green IT for datacenter configuration.

Permissions

Access to the Inventory page requires the following RBAC permissions:

PermissionDescription
vm.viewView virtual machines and containers, their status, and details
node.viewView Proxmox node information and resource usage

Users without these permissions will not see the Inventory entry in the sidebar.