---
name: "apcupsd-ups"
section: "8"
platform: "linux"
package: "nut"
version: "2.8.5-2"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/apcupsd-ups"
---

# apcupsd-ups(8)

Driver for apcupsd client access

## NAME

apcupsd-ups - Driver for apcupsd client access

## SYNOPSIS

**apcupsd-ups** -h

**apcupsd-ups** -a *UPS\_NAME* \[*OPTIONS*\]

**Note**\

This man page only documents the specific features of the **apcupsd-ups** driver. For information about the core driver, see [**nutupsdrv**(8)](/nutupsdrv/8.md).

## DESCRIPTION

This driver is a client to **apcupsd** (another UPS monitoring project).

**apcupsd-ups** acts as an **apcupsd** client, simply forwarding data. This can be useful in cases where both protocols are required in a network, or in case apcupsd code base has a required UPS access mode missing from NUT.

## EXTRA ARGUMENTS

This driver supports the following optional settings in [**nut.conf**(5)](/nut.conf/5.md):

**port**=\<hostname\>\[:\<port\>\]

This is the name of a remote host running apcupsd (plus an optional port).

For instance:

```
[apcupsd]
        driver = apcupsd-ups
        port = localhost
        desc = "apcupsd client"
```

For IPv6 addresses, use square brackets for the hostname part (so colons in it are not mistaken to be the port, especially if using the default one):

```
[apcupsd]
        driver = apcupsd-ups
        port = "[::1]:3551"
        desc = "apcupsd client"
```

## BACKGROUND

This driver was originally written in one evening to allow interoperating with **apcupsd**.

## SUPPORTED VARIABLES

The following variables are translated from **apcupsd** to NUT. All times should be converted to seconds (please file a bug if you notice a mismatch in units).

| | |
| --- | --- |
| **apcupsd variable** | **NUT variable(s)** |
| BCHARGE | battery.charge |
| MBATTCHG | battery.charge.low |
| RETPCT | battery.charge.restart |
| BATTDATE | battery.date |
| TIMELEFT | battery.runtime |
| MINTIMEL | battery.runtime.low |
| BATTV | battery.voltage |
| NOMBATTV | battery.voltage.nominal |
| LINEFREQ | input.frequency |
| SENSE | input.sensitivity |
| HITRANS | input.transfer.high |
| LOTRANS | input.transfer.low |
| LASTXFER | input.transfer.reason |
| LINEV | input.voltage |
| MAXLINEV | input.voltage.maximum |
| MINLINEV | input.voltage.minimum |
| NOMINV | input.voltage.nominal |
| LINEFREQ | output.frequency |
| OUTPUTV | output.voltage |
| NOMOUTV | output.voltage.nominal |
| DATE | ups.date, ups.time |
| DSHUTD | ups.delay.shutdown |
| DWAKE | ups.delay.start |
| FIRMWARE | ups.firmware, ups.firmware.aux |
| UPSNAME | ups.id |
| LOADPCT | ups.load |
| MANDATE | ups.mfr.date |
| NOMPOWER | ups.realpower.nominal |
| SERIALNO | ups.serial |
| STATUS | ups.status |
| ITEMP | ups.temperature |
| STESTI | ups.test.interval |
| SELFTEST | ups.test.result |

## LIMITATIONS

Access to **apcupsd** is strictly read only: no commands can be issued. This stems from the design of **apcupsd**, where the settings are changed in **apctest**. In order to run **apctest**, **apcupsd** must be stopped (and it is **apcupsd** that exposes the UPS to the network and to this NUT driver as its client).

## AUTHOR

Andreas Steinmetz

## SEE ALSO

[**ups.conf**(5)](/ups.conf/5.md), [**nutupsdrv**(8)](/nutupsdrv/8.md)

### Internet Resources:

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

• The apcupsd home page: http://www.apcupsd.org/

• Development of **apcupsd** project itself seems to have stalled in 2016/2017, with release 3.14.14 being the latest official tag. Its community discussions do remain quite active, however.

• Just in case, a replica of its sources is stored at https://github.com/networkupstools/apcupsd