NUT-IPMIPSU(8)

✨ NAME ✨

okay bestie, welcome to nut-ipmipsu — it's the driver for IPMI Power Supply Units (PSU), from the NUT Manual, section 8. yes, that's a whole driver just for your power supplies. she's niche, she's specialized, she's serving. 💅

---

🌸 SYNOPSIS 🌸

nut-ipmipsu -h

nut-ipmipsu -a PSU_NAME [OPTIONS]

Note — this driver is experimental, and still a work-in-progress. feedback is encouraged, so like, please tell us things 🫶

Note — this man page only documents the hardware-specific features of the nut-ipmipsu driver. for the core driver deets, go look at nutupsdrv(8). that's where the main-character lore lives. 👑

---

🦋 SUPPORTED HARDWARE 🦋

this driver should support a wide range of PSUs through the local IPMI interface. lowkey versatile of her.

nut-ipmipsu currently uses the GNU FreeIPMI project for the IPMI implementation. slay, standing on the shoulders of giants fr fr.

---

🎀 EXTRA ARGUMENTS 🎀

not a single optional setting. this driver doesn't support any optional settings. she said "no notes, I'm perfect as I am." ✨

---

💖 INSTALLATION 💖

so, this driver may be not built by default. not her fault, she's just shy. you can build it by installing the libfreeipmi-dev dependencies and using configure --with-ipmi=yes. that's the whole ritual. 🌈

you also need to give proper permissions on the local IPMI device file (/dev/ipmi0 for example) so the NUT user can actually access it. no permission, no access, it's giving locked out of the group chat. 😭

an udev rules file (nut-ipmipsu.rules) is provided and automatically installed on a udev enabled system. this file is generally installed in /etc/udev/rules.d/, or /lib/udev/rules.d/ on newer systems, to address the permission settings problem. thank you udev, you ate. 🔥

for more info, refer to scripts/udev/README.adoc in NUT sources. iykyk. 💜

---

🌟 INSTANT COMMANDS 🌟

nope. zero. none. this driver doesn't support any instant commands. periodt.

---

👑 IMPLEMENTATION 👑

the port value is used to identify the PSU. for instance, to target FRU 0x2, use the following in ups.conf:

[pdu]
        driver = nut-ipmipsu
        port = id2

this driver will report various information related to a PSU, including:

• manufacturer, model, serial and part numbers,
• nominal voltage and frequency,
• actual current and voltage,
• status of the PSU:
  • OL means that the PSU is present and providing power,
  • OFF means that the PSU is present but not providing power (power cable removed),
  • stale (no data) means that the PSU is not present (i.e. physically removed).

here is an example output for a Dell r610 server — look at her go, she's thriving 💅:

device.mfr: DELL
device.mfr.date: 01/05/11 - 08:51:00
device.model: PWR SPLY,717W,RDNT
device.part: 0RN442A01
device.serial: CN179721130031
device.type: psu
driver.name: nut-ipmipsu
driver.parameter.pollinterval: 2
driver.parameter.port: id2
driver.version: 2.6.1-3139M
driver.version.data: IPMI PSU driver
driver.version.internal: 0.01
input.current: 0.20
input.frequency.high: 63
input.frequency.low: 47
input.voltage: 232.00
input.voltage.maximum: 264
input.voltage.minimum: 90
ups.id: 2
ups.realpower.nominal: 717
ups.status: OL
ups.voltage: 12

---

💀 KNOWN ISSUES 💀

Using host names for UPS NMC

an UPS network management card may be assigned a fixed/static IP address or a dynamic one (e.g. by DHCP) in your network. due to this, you may want or have to use a dynamic naming service to access the UPS.

careful bestie — note that this may become a problem specifically during large outages and shutdowns, when your DHCP/DNS server might already go down while the driver needs to resolve the name involved (especially during late-shutdown hooks, when a new instance of the driver program might start just to tell the UPS to power off or to power-cycle). like, imagine the wifi dying right when you need it most. 💀

it may be wise to ensure your OS name service client can cache the UPS name sufficiently long, or to use fixed IP addressing (and an entry in /etc/hosts for good measure, so you only have one spot to eventually re-configure this). organization is self-care, fr fr. 🎀

---

🫶 AUTHOR 🫶

Arnaud Quette <arnaud.quette@free.fr> — thank you king, we appreciate you 🙏

---

🌈 SEE ALSO 🌈

The core driver:

• nutupsdrv(8)

Internet resources:

• The NUT (Network UPS Tools) home page: https://www.networkupstools.org/historic/v2.8.5/
• GNU FreeIPMI home page: http://www.gnu.org/software/freeipmi/

---

and that's the whole page, bestie!! this was Network UPS Tools 2.8.5, dated 10/07/2026. go forth and monitor your power supplies, you absolute legend. mwah 💋✨