netbox-proxbox v0.0.12
Compatible with proxbox-api v0.0.8 and NetBox ≥ 4.6.0.
Highlights
NetBox 4.6 compatibility
- Native
VirtualMachineTypesupport — QEMU and LXC VMs are now typed separately instead of using a shared generic type - Nullable cluster field on
VirtualMachine(required by NetBox 4.6) - Replace removed NetBox nested serializers with the new
nested=Truepattern across all serializers - Use
_siteinstead ofsitefor NetBox 4.6CachedScopeMixincompatibility in cluster queries - Extend
min_versionto4.5.0so the plugin continues to work on NetBox 4.5.x
New features
- Clusters list page and API endpoint —
/plugins/proxbox/clusters/now renders a full NetBox-style table view with filters and export - Top-level API paths — nodes, clusters, and virtual machines are now accessible at
/api/plugins/proxbox/nodes/,/api/plugins/proxbox/clusters/, and/api/plugins/proxbox/virtual-machines/ - Site and Tenant fields on ProxmoxEndpoint — closes issue #331
- Automated documentation screenshot pipeline — CI captures live screenshots of the plugin UI for docs
Bug fixes
- Fix N+1 cluster COUNT queries and deduplicate
vm_typeresolution in sync coordinator - Widen
VMTaskHistory.statusandexitstatustoTextFieldto handle long Proxmox values (issue #330) - Migration 0032 is now idempotent (
ADD COLUMN IF NOT EXISTS) so re-running migrations on an existing database does not fail - Expose
device_statusand Proxmox node metrics inNodesAPIViewandProxmoxNodeserializer responses - Custom fields cache is warmed before VM sync so
proxmox_last_updatedalways exists when device prerequisites are written
CI / testing
- Bump proxbox-api E2E image to
0.0.8and NetBox image tov4.6.0-beta1 - Replace local editable proxbox-api source with the published PyPI package in the lockfile
- SSE schema contract tests for VM interface stream routes
- Fix E2E custom-fields endpoint URL and ordering so device sync succeeds reliably
Compatibility
| NetBox | netbox-proxbox | proxbox-api | netbox-sdk | proxmox-sdk |
|---|---|---|---|---|
| ≥4.6.0 | v0.0.12 | v0.0.8 | v0.0.7.post4 | v0.0.2.post3 |
Installation
pip install netbox-proxbox==0.0.12
See the installation docs for full setup instructions.