Getting Started

Getting Started

Requirements

• Python 3.6+
• APC PowerChute Serial Shutdown for Business (port 6547)

No external Python packages are required.

Installation

git clone https://github.com/yo1t/apcget.git
cd apcget

Or simply download apcget.py directly.

Quick Start

your_username and your_password are the credentials you configured in PowerChute (not OS credentials).

1. Get UPS load (default)

python3 apcget.py 192.168.1.100 your_username your_password
# Output: 19.0

2. Get specific items

python3 apcget.py 192.168.1.100 your_username your_password --battery
# Output: 100.0

python3 apcget.py 192.168.1.100 your_username your_password --load --runtime --voltage
# Output: 19.0 29 102.0

3. Use a config file (recommended)

Create ~/.apcget.conf:

[powerchute]
ip = 192.168.1.100
username = your_username
password = your_password

chmod 600 ~/.apcget.conf
python3 apcget.py --battery

See Credential Management for more details.

Next Steps

• Available Items — see all retrievable items
• Zabbix Integration — send data to Zabbix automatically