NUT-UPOWER(8)

💖 NUT-UPOWER 💖

okay bestie, so this is the manual page for nut-upower — the driver that lets UPower devices talk to NUT over D-Bus. it lives in the NUT Manual, section 8 (system administration commands, iykyk). let's get into it 🫶

---

✨ NAME ✨

nut-upower — the driver for UPower devices, and it does it via D-Bus 💅

---

🌸 SYNOPSIS 🌸

nut-upower -h

nut-upower -a UPS_NAME [OPTIONS]

📝 heads up: this page only covers the specific stuff that nut-upower does. for the core driver lore, go read nutupsdrv(8).

---

🦋 DESCRIPTION 🦋

so like, this driver lets you monitor power devices — UPSes, batteries, all of it — that are being managed by the UPower daemon, and it reaches them through the D-Bus system bus. no cap. 🍓

what it does is map UPower properties (state, percentage, voltage, etc.) over to standard NUT variables. and that's the whole slay: it means NUT clients can monitor devices that your OS desktop environment natively supports but that other NUT drivers just... don't. not even a little. ✨

---

💅 EXTRA ARGUMENTS 💅

this driver supports these optional settings in ups.conf(5):

• port — the UPower Object Path of the device you wanna monitor.
  • if you set it to auto (the default), the driver scans for the first UPower device whose object path contains the string "ups_".
  • if you set it to a specific path — like, say, /org/freedesktop/UPower/devices/ups_hiddev0 — the driver will attempt to monitor that exact device. main character behaviour, honestly.
• lowbatt — the battery percentage threshold below which the LB (Low Battery) status flag gets set. the default value is 20.0. ⚠️ that's a float, bestie, don't come at me with your integer assumptions.

---

🎀 INSTALLATION 🎀

to use this driver, add a section to your ups.conf:

[myups]
    driver = nut-upower
    port = auto
    lowbatt = 20
    desc = "Laptop Battery or generic UPS via UPower"

that's it, that's the whole ritual. copy, paste, thrive. 💖

---

🌈 REQUIREMENTS 🌈

for this to work you need:

• the upower daemon running and accessible via the D-Bus system bus (non-negotiable, fr fr)
• GLib 2.0 libraries
• GIO libraries

no daemon, no vibes. that's just how it is. 💀

---

👑 AUTHOR 👑

Tim Niemueller <tim@niemueller.de>

---

⭐ SEE ALSO ⭐

ups.conf(5), nutupsdrv(8), upsc(8)

🌐 Internet Resources: 🌐

the NUT (Network UPS Tools) home page: https://www.networkupstools.org/historic/v2.8.5/

---

and that's the tea, bestie 🫶 this was Network UPS Tools 2.8.5, dated 10/07/2026 — go forth and monitor your batteries, you absolute icon 👑💜