2025.4.4
Home ▸ Integrations ▸

APC UPS Daemon

apcupsd status information can be integrated into Home Assistant when the Network Information Server (NIS) is configured on the APC device.

Prerequisites

  1. Install apcupsd.

    First, install apcupsd on the machine connected to your UPS. It works on Linux, macOS, Windows, BSD, Solaris, and more.
    You can usually install it through your operating system’s package manager.

  2. Configure apcupsd for network access.

    • Open the apcupsd.conf file (usually found in /etc/apcupsd/) and make sure it’s set to listen for network connections.
    • Look for the line: NISIP 0.0.0.0.
    • This setting allows it to accept connections on all network interfaces.
    • If you prefer, you can set this to a specific IP address that Home Assistant can reach.

  3. Start the apcupsd service.

Configuration

To add the APC UPS Daemon integration to your Home Assistant instance, use this My button:

Manual configuration steps

If the above My button doesn’t work, you can also perform the following steps manually:

  • Browse to your Home Assistant instance.

  • Go to Settings > Devices & Services.

  • In the bottom right corner, select the Add Integration button.

  • From the list, select APC UPS Daemon.

  • Follow the instructions on screen to complete the setup.

Note

If you get ConnectionRefusedError: Connection refused errors in the Home Assistant logs, it means that Home Assistant is not able to connect to the daemon. Please check if the NISIP is properly configured.

Binary sensor

This integration provides a binary sensor for the following information from apcupsd:

  • UPS status

Sensors

This integration provides sensors for the following information from apcupsd based on their availability. Each sensor is listed here along with their corresponding resource name obtained from apcaccess.

Note

Some sensors are disabled by default, since they provide information that is only useful for advanced users. You can manually enable them in Settings -> Devices & Services -> Entities -> the sensor entity you want to enable -> Advanced settings -> Enabled.

  • UPS Alarm Delay (ALARMDEL)
  • UPS Ambient Temperature (AMBTEMP)
  • UPS Status Data (APC)
  • UPS Model (APCMODEL)
  • UPS Bad Batteries (BADBATTS)
  • UPS Battery Replaced (BATTDATE)
  • UPS Battery Status (BATTSTAT)
  • UPS Battery Voltage (BATTV)
  • UPS Battery (BCHARGE)
  • UPS Cable Type (CABLE)
  • UPS Total Time on Battery (CUMONBATT)
  • UPS Status Date (DATE)
  • UPS Dip Switch Settings (DIPSW)
  • UPS Low Battery Signal (DLOWBATT)
  • UPS Driver (DRIVER)
  • UPS Shutdown Delay (DSHUTD)
  • UPS Wake Delay (DWAKE)
  • UPS Date and Time (END APC)
  • UPS External Batteries (EXTBATTS)
  • UPS Firmware Version (FIRMWARE)
  • UPS Transfer High (HITRANS)
  • UPS Hostname (HOSTNAME)
  • UPS Ambient Humidity (HUMIDITY)
  • UPS Internal Temperature (ITEMP)
  • UPS Last Transfer (LASTXFER)
  • UPS Input Voltage Status (LINEFAIL)
  • UPS Line Frequency (LINEFREQ)
  • UPS Input Voltage (LINEV)
  • UPS Load (LOADPCT)
  • UPS Load Apparent Power (LOADAPNT)
  • UPS Transfer Low (LOTRANS)
  • UPS Manufacture Date (MANDATE)
  • UPS Master Update (MASTERUPD)
  • UPS Input Voltage High (MAXLINEV)
  • UPS Battery Timeout (MAXTIME)
  • UPS Battery Shutdown (MBATTCHG)
  • UPS Input Voltage Low (MINLINEV)
  • UPS Shutdown Time (MINTIMEL)
  • UPS Model (MODEL)
  • UPS Battery Nominal Voltage (NOMBATTV)
  • UPS Nominal Input Voltage (NOMINV)
  • UPS Nominal Output Voltage (NOMOUTV)
  • UPS Nominal Output Power (NOMPOWER)
  • UPS Nominal Apparent Power (NOMAPNT)
  • UPS Transfer Count (NUMXFERS)
  • UPS Output Current (OUTCURNT)
  • UPS Output Voltage (OUTPUTV)
  • UPS Register 1 Fault (REG1)
  • UPS Register 2 Fault (REG2)
  • UPS Register 3 Fault (REG3)
  • UPS Restore Requirement (RETPCT)
  • UPS Last Self Test (LASTSTEST)
  • UPS Self Test Result (SELFTEST)
  • UPS Sensitivity (SENSE)
  • UPS Serial Number (SERIALNO)
  • UPS Startup Time (STARTTIME)
  • UPS Status Flag (STATFLAG)
  • UPS Status (STATUS)
  • UPS Self Test Interval (STESTI)
  • UPS Time Left (TIMELEFT)
  • UPS Time on Battery (TONBATT)
  • UPS Mode (UPSMODE)
  • UPS Name (UPSNAME)
  • UPS Daemon Info (VERSION)
  • UPS Transfer from Battery (XOFFBAT)
  • UPS Transfer from Battery (XOFFBATT)
  • UPS Transfer to Battery (XONBATT)

Removing the integration

This integration follows standard integration removal. No extra steps are required.

To remove an integration instance from Home Assistant

  1. Go to Settings > Devices & services and select the integration card.
  2. From the list of devices, select the integration instance you want to remove.
  3. Next to the entry, select the three-dot menu. Then, select Delete.