Configuration

netbox-pbs uses the same proxbox-api backend as netbox-proxbox.

Plugin settings

Create or edit the netbox-proxbox FastAPIEndpoint that points at proxbox-api, then select that endpoint in the netbox-pbs plugin settings page at Plugins > PBS > Settings. The settings page only stores this foreign key; backend URL and token details remain owned by netbox-proxbox.

PLUGINS = [
    "netbox_proxbox",
    "netbox_pbs",
]

PBS server write-through

PBSServer rows in NetBox mirror existing proxbox-api /pbs/endpoints records. When a server is created or edited through the NetBox UI or API, netbox-pbs updates the matching backend endpoint before saving the NetBox row. This keeps shared connection fields such as host, port, token_id, fingerprint, and verify_ssl from drifting.

Matching uses the endpoint name first, then host plus port; edits prefer the pre-save identity so renames update the existing backend row. If no backend endpoint matches, NetBox rejects the save; create the PBS endpoint in proxbox-api first because NetBox does not store the backend token_secret.