nut-upower - Man Page

Driver for UPower devices via D-Bus

Synopsis

nut-upower -h

nut-upower -a UPS_NAME [OPTIONS]

Note

This man page only documents the specific features of the nut-upower driver​. For information about the core driver, see nutupsdrv(8)​.

Description

This driver allows the monitoring of power devices (UPS, batteries) that are managed by the UPower daemon via the D-Bus system bus​.

It maps UPower properties (state, percentage, voltage, etc​.) to standard NUT variables, allowing NUT clients to monitor devices that are natively supported by the OS desktop environment but not directly by other NUT drivers​.

Extra Arguments

This driver supports the following optional settings in ups.conf(5):

port

The UPower Object Path of the device to monitor​.

If set to auto (the default), the driver will scan for the first UPower device whose object path contains the string "ups_"​.

If set to a specific path (e​.g​., /org/freedesktop/UPower/devices/ups_hiddev0), the driver will attempt to monitor that specific device​.

lowbatt

The battery percentage threshold below which the LB (Low Battery) status flag is set​. The default value is 20​.0​.

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"

Requirements

This driver requires the upower daemon to be running and accessible via the D-Bus system bus​. It also requires GLib 2​.0 and GIO libraries​.

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/

Info

10/07/2026 Network UPS Tools 2.8.5 NUT Manual