Skip to content

Repository files navigation

mibs.librenms.org

Static browser for every SNMP MIB shipped with LibreNMS, published at https://mibs.librenms.org.

Build locally

Requirements: uv, git, net-snmp (snmptranslate; Debian/Ubuntu apt install snmp, Arch pacman -S net-snmp).

scripts/build.sh                      # fetch LibreNMS into .cache/librenms and build ./site
scripts/build.sh --only 'cisco/*'     # build a subset
python3 -m http.server -d site 8000   # preview
uv run pytest                         # tests

How it works

Each MIB is parsed by the first tier that succeeds: pysmi → net-snmp snmptranslate → regex scrape → raw. Every MIB gets a page; the badge shows which tier was used and any parser messages are listed. Import aliases follow net-snmp's module_map (e.g. RFC-1213 → RFC1213-MIB). Vendors come from the IANA enterprise number of the MIB's root OID. Example values come from LibreNMS tests/snmpsim/*.snmprec. Search is a static, prefix-sharded JSON index under /data/search/.

External MIBs

extra-mibs/ holds public MIBs that LibreNMS MIBs import but LibreNMS does not ship. Refresh with uv run mibsite fetch-extra. Sources are listed in extra-mibs/SOURCES.md.

Deployment

.github/workflows/build.yml builds on push to master, on manual dispatch and on a librenms-mibs-updated repository dispatch (sent by LibreNMS CI when its MIBs change), then deploys to GitHub Pages.

Contributors

Languages