netbox-pdm

netbox-pdm is a NetBox plugin that brings Proxmox Datacenter Manager (PDM) inventory into NetBox. It is a sibling of netbox-proxbox and uses the proxbox-api backend to resolve FastAPI endpoints and jobs. When netbox-proxbox is installed, it reuses that plugin's endpoint resolution and job conventions; otherwise it falls back to its own proxbox_api_url and proxbox_api_key settings. netbox-proxbox remains a required peer plugin in PLUGINS, though it is not a Python wheel dependency, so the Proxbox stack can share a Pydantic line with proxmox-sdk. The v0.0.2 release provides PDM endpoint and remote inventory views, sync job wiring, and a proxmox-sdk-backed PDM client path. Synchronization reconciles NetBox inventory rows only; the plugin never writes configuration back to PDM. It creates, updates and prunes PDMRemote rows, so remotes removed from PDM do not remain as stale NetBox inventory. Endpoint sync requires endpoint visibility and the core.add_job permission. PDM token secrets are not rendered back into endpoint edit forms; leaving the field blank preserves the stored secret. Installation uses pip install netbox-proxbox netbox-pdm, adds both plugins to PLUGINS, and runs python manage.py migrate. Documentation is published on GitHub Pages, and bugs and feature requests are tracked via GitHub Issues. The project is Apache-2.0 licensed and includes PyPI metadata, compatibility metadata, GitHub Actions CI, release validation, docs publishing, screenshot capture, and page-coverage workflows for NetBox v4.6.4. Digest-pinned Docker install smoke covers NetBox v4.7.0 GA, and exact-source integration tests cover v4.5.8 through v4.6.6; 4.7.1 and later fail closed. See COMPATIBILITY.md for version tiers and the Proxbox-family upgrade procedure.