Skip to content

APC UPS

apcupsd looks after an APC UPS. This shows its status, charge, time left and load, over apcupsd’s network port.

config.yaml
integrations:
apcups:
type: apcups
host: ups.example
title: UPS
layout:
- title: Infrastructure
widgets:
- apcups.status
OptionTypeDefaultWhat it does
hoststringrequiredWhere apcupsd’s network port is.
portwhole number3551apcupsd’s network port. Range -9007199254740991 to 9007199254740991.
titlestringUPSThe card’s title.

One widget. Its key is apcups.status, using the instance name from your config.

apcups.status · stats card · refreshes every 30 seconds while the page is open.

APC UPS, UPS, small size
Small
APC UPS, UPS, wide size
Wide
APC UPS, UPS, medium size
Medium
APC UPS, UPS, large size
Large
APC UPS, UPS, in chat
In chat

Tall draws the same as medium, so it isn't shown. Only the empty space changes.

APC UPS UPS: On battery
On battery
APC UPS UPS: Can't reach it
Can't reach it

What the assistant can use, once its access level allows it. Read tools run freely. Everything else asks first.

ToolAccessWhat it does
ups_statusreadUPS status: on mains or battery, charge, minutes left, load.