| Port variant | v13 |
| Summary | Proxmox plugin for Netbox (3.13) |
| Package version | 0.0.19 |
| Homepage | https://github.com/emersonfelipesp/netbox-proxbox |
| Keywords | python |
| Maintainer | Python Automaton |
| License | Not yet specified |
| Other variants | v14 |
| Ravenports | Buildsheet | History |
| Ravensource | Port Directory | History |
| Last modified | 30 MAY 2026, 02:26:15 UTC |
| Port created | 08 JAN 2023, 04:18:24 UTC |
| single | # Proxbox Proxbox is a NetBox plugin that synchronizes Proxmox infrastructure data into NetBox. It keeps your DCIM up-to-date with real Proxmox clusters, nodes, virtual machines, containers, backups, and Firecracker micro-VM inventory used by the NMS Cloud runtime. ![netbox-proxbox architecture] ## What It Does Proxbox discovers and syncs the following from Proxmox into NetBox: - **Clusters and Nodes** — Proxmox cluster name, mode (cluster/standalone), quorum status, node count, and Proxmox VE version. Each node includes online status, IP address, CPU usage, memory usage, and uptime at sync time. Optionally link to NetBox Cluster and Device objects. - **Virtual Machines** — VM status, resources, and configuration - **Containers (LXC)** — Container details and settings - **Firecracker Cloud inventory** — Host pools, host-agent VMs, image templates, and provisioned micro-VMs exposed separately from QEMU/LXC for NMS Cloud provisioning - **VM Snapshots** — Point-in-time snapshots for recovery - **VM Backups** — Backup jobs and restore points - **Storage** — Datastores and storage content - **Network Interfaces and IPs** — Network interfaces and IP addresses assigned to VMs and containers - **Backup Routines** — Backup job definitions from Proxmox - **Replications** — Replication job status and configuration > **Note:** All metrics (CPU, memory, uptime, etc.) are captured as point-in-time snapshots at sync time, not continuous monitoring. Sync runs on-demand from the NetBox UI or scheduled automatically via NetBox's job system. ## Additional Optional Plugins Proxbox can be extended with standalone companion plugins. Install only the plugins you need; `netbox-proxbox` remains the base plugin and must be enabled before any companion plugin. The infrastructure inventory plugins declare `netbox-proxbox>=0.0.18` as a dependency, and `netbox-packer` follows the same operational conventions for the Proxbox plugin family. | Package | NetBox plugin | What it adds | |---------|---------------|--------------| | [`netbox-pdm`] | `netbox_pdm` | Inventories Proxmox Datacenter Manager endpoints and the PVE/PBS remotes managed by PDM. It links PDM remotes back to Proxbox Proxmox endpoints and, when installed, `netbox-pbs` backup servers. | | [`netbox-pbs`] | `netbox_pbs` | Inventories Proxmox Backup Server infrastructure, including PBS servers, datastores, backup snapshots, and scheduled job history. | | [`netbox-ceph`] | `netbox_ceph` | Adds read-only Ceph cluster inventory for Proxmox-managed Ceph: clusters, daemons, OSDs, pools, filesystems, CRUSH rules, flags, and health checks. | | [`netbox-packer`] | `netbox_packer` | Tracks HashiCorp Packer image definitions and build execution records for Proxmox VM templates and image-factory workflows. | For a standard NetBox virtualenv install, activate the NetBox environment and install the packages you want: ```bash source /opt/netbox/venv/bin/activate pip install netbox-pbs netbox-pdm netbox-ceph netbox-packer ``` Enable the selected plugins in `netbox/netbox/configuration.py`. Keep `netbox_proxbox` first. If you enable `netbox_pdm`, enable `netbox_pbs` before it because PDM can link to PBS server records. ```python PLUGINS = [ "netbox_proxbox", "netbox_pbs", "netbox_pdm", "netbox_ceph", "netbox_packer", ] ``` Run migrations for the selected plugins, preserving the same order: ```bash cd /opt/netbox/netbox python3 manage.py migrate netbox_proxbox python3 manage.py migrate netbox_pbs python3 manage.py migrate netbox_pdm python3 manage.py migrate netbox_ceph python3 manage.py migrate netbox_packer python3 manage.py collectstatic --no-input sudo systemctl restart netbox netbox-rq ``` For `netbox-docker`, add the selected packages to |
| Build (only) |
python313:dev:std python-pip:single:v13 autoselect-python:single:std |
| Build and Runtime | python313:primary:std |
| Runtime (only) |
python-cryptography:single:v13 python-pydantic:single:v13 python-requests:single:v13 python-websockets:single:v13 |
| main | mirror://PYPIWHL/67/f6/28d4a7cf1cad30d3da1ad1ce4fbbf063c9d1019415eb9010056f06855f9a |
| No other ports depend on this one. |