Skip to content

Virtual Machine Data Model

Proxbox stores synchronized compute inventory in NetBox's built-in virtualization.VirtualMachine model rather than a plugin-specific VM table.

Current Behavior

  • Proxmox QEMU guests and LXC containers are both represented as NetBox virtual machines.
  • The plugin separates them in the UI by filtering on Proxbox-managed metadata such as guest type.
  • Related plugin-side records include VMBackup, VMSnapshot, VMTaskHistory, and storage links through ProxmoxStorage.
  • VMs that carry a resolvable proxmox_vm_id (custom field set during sync) gain a read-only HA tab on the detail page, sibling to Proxmox Config. The tab queries the paired proxbox-api and is hidden when the VM has not been synced through Proxbox. See High Availability (HA).

See Virtual Machine for the user-facing view split between VMs and containers.