Skip to content
Thib3113 edited this page Aug 23, 2026 · 3 revisions

nut-client

A Node.js client for Network UPS Tools (NUT), enabling advanced communication with NUT servers for UPS management.

Features

  • NUT Command Support — Most NUT commands are supported, with automatic parsing and a manual mode for raw protocol access.
  • Parallel Request Handling — Internal command queue serializes requests without conflicts.
  • Auto-Reconnect — Exponential backoff with jitter, configurable limits, and automatic session restoration (auth + TLS).
  • StartTLS — Secure communication with the NUT server.
  • UPS Object — Typed convenience methods for status, battery, load, model, and more.
  • Built-in Monitor — Event-based monitoring with status events, "NOT" events, variable change tracking, and reconnect integration.
  • Command Tracking — Track long-running write operations with automatic polling via followTracking.
  • TypeScript — Fully typed, distributed as dual ESM + CJS.

Quick Links

Requirements

  • Node.js >= 18
  • NUT server (upsd) accessible on the network

License

MIT

Clone this wiki locally