Skip to content

v0.1.0 — first public release

Choose a tag to compare

@Fill84 Fill84 released this 26 Apr 20:02
· 7 commits to main since this release

First public release of procurve-webui — a modern Java-applet-free management UI for the HP ProCurve Switch 2810-24G (J9021A).

What's in this release

A single Docker container that gives you:

  • Identity — model, serial, firmware, MAC, IP, uptime, CPU, memory.
  • Status — live SVG chassis with per-port LEDs, port-utilisation chart (Recharts), alert log with ack/delete/detail dialog, WebSocket-fed live counters.
  • Configuration — system info, IP, per-port settings, device features, fault detection, port mirroring, QoS, support URLs. Full write support, READ_ONLY=true by default.
  • Security — web access mode, authorised-managers (lockout-gated), per-port security, intrusion log, SSL state inspection.
  • Diagnostics — ICMP ping, link test, configuration report, factory reset.
  • Backups — list / take / diff / download / restore .pcc snapshots, with auto-backup before every write.
  • Support — replaces the legacy procurve.com redirect with the modern HPE Networking portal.

The whole thing talks to the switch over the same HTTP protocol the original agent.jar used — fully reverse-engineered in Phase 0 and documented under research/protocol/.

Quick start

git clone https://github.com/Fill84/procurve-webui.git
cd procurve-webui
cp .env.example .env
# Edit .env: set SWITCH_HOST and a real SESSION_SECRET
python -c "import secrets; print(secrets.token_urlsafe(32))"
docker compose up -d

Then browse to http://localhost:8080 and log in with your switch credentials (blank/blank on factory firmware).

See the README for the full setup, configuration reference, security considerations and per-tab feature tour.

Hardware support

Status Hardware
Confirmed working HP ProCurve 2810-24G (J9021A), firmware N.11.78
Likely working (untested) Other 2810-series running the N.x firmware family
Not supported 2510 / 2610 / 2810-Plus (different firmware lines)

If you successfully run this against any other ProCurve hardware, please open an issue or PR — the table in the README has a "Likely working" row that's begging for confirmations.

Not redistributed

  • research/applet/agent.jar — HPE's compiled Java applet. See research/applet/README.md for how to mirror it from your own switch.
  • research/backups/**/*.pcc — operator-specific config snapshots. See research/backups/README.md to recreate a baseline locally.

License

Released under the MIT License. "HP", "ProCurve", and "2810-24G" are trademarks of Hewlett Packard Enterprise; this project is not affiliated with HPE.