# netbox-pdm

NetBox plugin for Proxmox Datacenter Manager — models PDM nodes, remote clusters, subscriber views, and SDN topology.

| Field |Value |
| --- | --- |
| Canonical URL | https://emersonfelipesp.com/netbox-pdm |
| GitHub | https://github.com/emersonfelipesp/netbox-pdm |
| Developer guide | https://emersonfelipesp.com/netbox-pdm/developer |
| Roadmap | https://emersonfelipesp.com/netbox-pdm/roadmap |
| Releases | https://emersonfelipesp.com/netbox-pdm/releases |
| Stars | 0 |
| Forks | 0 |
| Latest release | v0.0.1 |

## Overview

netbox-pdm brings Proxmox Datacenter Manager (PDM) awareness into NetBox, mapping the multi-cluster topology managed by PDM into structured DCIM objects.

PDM nodes, remote cluster registrations, subscriber assignments, and scheduled tasks are all surfaced in NetBox alongside the rest of your infrastructure inventory.

## Features

- PDM node discovery and status tracking
- Remote cluster registration and subscriber view mapping
- Scheduled task visibility per PDM node
- SDN zone and VNET topology modeled as NetBox objects
- Links PDM objects to existing Proxmox cluster records
- Read-only discovery — never mutates resources on PDM
- REST API for all plugin models

## Stack

- NetBox plugin (Django / Python 3.12+)
- Proxmox Datacenter Manager API integration
- netbox-proxbox (companion plugin for cluster context)

## Install

Primary command:

```shell
pip install netbox-pdm
```

Requires a running Proxmox Datacenter Manager instance and netbox-proxbox for cluster context.

## Links

| Label |URL |
| --- | --- |
| repo | https://github.com/emersonfelipesp/netbox-pdm |
| netbox-proxbox | https://emersonfelipesp.com/netbox-proxbox |
| Proxmox PDM Docs | https://pve.proxmox.com/pve-docs/pdm-admin-guide.html |