# netbox-proxbox v0.0.12

netbox-proxbox v0.0.12

| Field |Value |
| --- | --- |
| Canonical URL | https://emersonfelipesp.com/netbox-proxbox/releases/v0.0.12 |
| GitHub URL | https://github.com/emersonfelipesp/netbox-proxbox/releases/tag/v0.0.12 |
| Tag | v0.0.12 |
| State | stable |
| Author | emersonfelipesp |
| Created | 2026-04-23 17:20 UTC |
| Published | 2026-04-23 18:03 UTC |
| Target | develop |
| Synced | 2026-08-26 19:44 UTC |
| Assets | 0 |

## Release notes

## netbox-proxbox v0.0.12

Compatible with **proxbox-api v0.0.8** and **NetBox ≥ 4.6.0**.

### Highlights

#### NetBox 4.6 compatibility
- Native `VirtualMachineType` support — 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=True` pattern across all serializers
- Use `_site` instead of `site` for NetBox 4.6 `CachedScopeMixin` compatibility in cluster queries
- Extend `min_version` to `4.5.0` so 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_type` resolution in sync coordinator
- Widen `VMTaskHistory.status` and `exitstatus` to `TextField` to 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_status` and Proxmox node metrics in `NodesAPIView` and `ProxmoxNode` serializer responses
- Custom fields cache is warmed before VM sync so `proxmox_last_updated` always exists when device prerequisites are written

#### CI / testing
- Bump proxbox-api E2E image to `0.0.8` and NetBox image to `v4.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](https://emersonfelipesp.github.io/netbox-proxbox/) for full setup instructions.

## Assets

No binary assets attached.

Source archives:

| Format |URL |
| --- | --- |
| zip | https://api.github.com/repos/emersonfelipesp/netbox-proxbox/zipball/v0.0.12 |
| tar.gz | https://api.github.com/repos/emersonfelipesp/netbox-proxbox/tarball/v0.0.12 |