Repository navigation
v0.1.0 — first public 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=trueby 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
.pccsnapshots, with auto-backup before every write. - Support — replaces the legacy
procurve.comredirect 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 -dThen 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. Seeresearch/applet/README.mdfor how to mirror it from your own switch.research/backups/**/*.pcc— operator-specific config snapshots. Seeresearch/backups/README.mdto 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.