FreeSDN Plugin Registry
← All plugins

monitoring

Port Hygiene

Finds the switch-port problems nothing else looks for: ports enabled with no link for weeks, links negotiating half duplex, climbing error counters, live ports on the default VLAN, and switches running out of PoE headroom. Reports only, never changes a port.

switchesportspoevlanhygiene

Runs on a timer

This plugin declares work FreeSDN will run for you, per organisation. Every schedule can be switched off from Plugins in the UI.

port_scan
every 6h · on by default
Walk every switch port and report what has gone wrong. Read-only against your gear: it inspects the port tables FreeSDN already holds. Six-hourly, because none of these conditions appear in minutes.

Package

Plugin ID
port-hygiene
Version
1.0.0
Author
FreeSDN
Minimum core
26.06.1
Python
>=3.11
SHA-256
6abae89fb2cdf040854294159de070d6ccb6e1b6cf54247a258090e7f7f46e4c

Install

From inside FreeSDN, open Plugins › Marketplace, sync the catalogue, and install Port Hygiene. The instance verifies the catalogue signature before ingest and the archive checksum before unpacking.

To install the archive directly instead:

curl -fSLO https://registry.freesdn.org/dl/port-hygiene-1.0.0.zip
sha256sum port-hygiene-1.0.0.zip
# expect: 6abae89fb2cdf040854294159de070d6ccb6e1b6cf54247a258090e7f7f46e4c

Then upload the ZIP under Plugins › Install from file.

Plugins run in-process with the API. The loader applies import hygiene, ZIP-slip and ZIP-bomb guards, hash-pinned dependencies and per-action permission caps, but it is a cooperative trusted-author model and not a security sandbox. Install what you would be willing to run as application code.

Source and issues →