# netbox-proxbox v0.0.18

v0.0.18

| Field |Value |
| --- | --- |
| Canonical URL | https://emersonfelipesp.com/netbox-proxbox/releases/v0.0.18 |
| GitHub URL | https://github.com/emersonfelipesp/netbox-proxbox/releases/tag/v0.0.18 |
| Tag | v0.0.18 |
| State | latest |
| Author | emersonfelipesp |
| Created | 2026-05-21 23:50 UTC |
| Published | 2026-05-22 02:21 UTC |
| Target | develop |
| Synced | 2026-05-22 18:57 UTC |
| Assets | 0 |

## Release notes

# Version 0.0.18

## Summary

Version `0.0.18` adds **full Proxmox VE 9.2 support** to the plugin, including
persisted Django models for SDN fabrics, route maps, prefix lists, and custom
datacenter CPU models; automated sync services for these new objects; completed
node-level firewall sync; and HA arm/disarm action views. It pairs with
backend [`proxbox-api 0.0.14`](https://github.com/emersonfelipesp/proxbox-api),
which ships the SDN, CPU-model, and datacenter-options endpoints that power
the new sync services.

The NetBox compatibility range remains `4.5.8` – `4.6.99` (`min_version` /
`max_version` unchanged). Django migration `0041_pve_9_2.py` adds four tables
and one new column; run `manage.py migrate netbox_proxbox` after upgrade.

## What's New In The Plugin

- **SDN model scaffolding.** Three new Django models persist Proxmox VE SDN
  objects: `ProxmoxSdnFabric` (WireGuard / BGP / VXLAN / OSPF fabrics),
  `ProxmoxSdnRouteMap`, and `ProxmoxSdnPrefixList`. Full CRUD views, REST API
  viewsets, and a new **SDN** navigation group are included.
- **Datacenter CPU model scaffolding.** New `ProxmoxDatacenterCpuModel` model
  with full CRUD and REST API; listed under the **Infrastructure** navigation
  group.
- **SDN and CPU-model sync services.** `services/sync_sdn.py` calls
  `GET /proxmox/sdn/fabrics`, `/sdn/route-maps`, and `/sdn/prefix-lists`.
  `services/sync_datacenter.py` calls `GET /proxmox/datacenter/cpu-models`.
  Both upsert records and mark removed rows stale.
- **Completed node-level firewall sync.** `services/sync_firewall.py` gains
  `sync_node_firewall()` (calls `GET /proxmox/firewall/nodes/{node}/rules`)
  so per-node `ProxmoxFirewallRule` rows are populated automatically during
  the sync job. `sync_vm_firewall()` is also implemented and available for
  per-VM rule ingestion, but is not yet wired into the automatic sync job.
- **HA arm/disarm action views.** `HaArmView` and `HaDisarmView` proxy to
  `POST /proxmox/cluster/ha/arm` and `POST /proxmox/cluster/ha/disarm` on
  the backend. Both require `change_proxmoxendpoint` permission and return
  JSON for AJAX callers.
- **`ProxmoxNode.location` field.** Stores the geographic or physical location
  of a node as reported by PVE 9.2+.

## What's New In The Backend (`proxbox-api 0.0.14`)

The plugin requires `proxbox-api >= 0.0.14`. The backend release adds:

- `GET /proxmox/sdn/fabrics`, `GET /proxmox/sdn/route-maps`,
  `GET /proxmox/sdn/prefix-lists` — per-cluster SDN topology reads.
- `GET /proxmox/datacenter/cpu-models` — custom CPU model enumeration.
- `GET /proxmox/datacenter/options` — datacenter-level options including
  CRS (Cluster Resource Scheduling) settings.
- `POST /proxmox/cluster/ha/arm` and `POST /proxmox/cluster/ha/disarm` —
  cluster HA arm/disarm verbs (write-gated by `allow_writes`).
- `GET /proxmox/cluster/ha/manager-status` — HA manager state endpoint.
- Extended node config: `location` field in node config responses.
- Access token management endpoints.

## Compatibility

| NetBox   | netbox-proxbox | proxbox-api | netbox-sdk     | proxmox-sdk    |
|----------|----------------|-------------|----------------|----------------|
| >=4.5.8  | v0.0.18 | v0.0.14 | v0.0.8.post1 | v0.0.3.post1 |
| >=4.5.8  | v0.0.17 | v0.0.13 | v0.0.8.post1 | v0.0.3.post1 |

NetBox compatibility range: `4.5.8` – `4.6.99` (unchanged). Certified
simultaneously against NetBox `v4.5.8`, `v4.5.9`, `v4.6.0`, and `v4.6.1`.

## Upgrade Notes

- **Run `manage.py migrate netbox_proxbox`** — migration `0041_pve_9_2.py`
  creates the `proxmoxsdnfabric`, `proxmoxsdnroutemap`, `proxmoxsdnprefixlist`,
  and `proxmoxdatacentercpumodel` tables and adds the `location` column to
  `proxmoxnode`.
- **Upgrade the backend to `proxbox-api 0.0.14`** before the plugin so the
  `/proxmox/sdn/*` and `/proxmox/datacenter/cpu-models` routes are available.
- Restart the NetBox WSGI process after migration and static-file collection.
- The read-only reflection path for existing objects is unchanged.

## Assets

No binary assets attached.

Source archives:

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