jackery-ha

Home Assistant custom integration for Jackery power stations, distributed via HACS.

Features

• 18 sensors — battery level, power input/output, temperature, voltage, frequency, charge timers, diagnostics
• 3 binary sensors — wireless charging status, temperature & power alarms
• 8 switches — AC/DC/USB/car output, AC/DC input, super fast charge, UPS mode
• 3 selects — light mode, charge speed, battery protection level
• 3 numbers — auto shutdown timer, energy saving timer, screen timeout
• Diagnostics — debug data export with automatic credential redaction

All communication goes through the socketry PyPI package — no direct HTTP or MQTT calls.

Installation

HACS (recommended)

1. Open HACS in your Home Assistant instance
2. Add this repository as a custom repository (Integration type)
3. Search for "Jackery Power Stations" and install
4. Restart Home Assistant

Manual

Copy the custom_components/jackery/ directory into your Home Assistant custom_components/ directory and restart.

Configuration

1. Go to Settings → Devices & Services → Add Integration
2. Search for Jackery Power Stations
3. Enter your Jackery app email and password

Dedicated Account (Recommended)

Jackery only allows one device to be logged in to an account at a time — a new login will log out the previous device. Because of this, it is recommended that you create a separate Jackery account dedicated to Home Assistant, so the integration doesn't interfere with your mobile app.

To share your devices with the new account:

1. Create a new Jackery account (e.g. using a different email)
2. Add the integration in Home Assistant using the new account credentials
3. On the Jackery integration entry, click the gear icon (Configure)
4. A QR code will be displayed
5. In the Jackery mobile app on your main account, select the device you want to share, open its settings, and tap Scan to share device(s) to scan the QR code
6. Click Submit in Home Assistant to reload the integration and pick up the newly shared devices

If your account already has devices (e.g. you're using your main account), they'll be discovered automatically and setup completes immediately.

Entities

Sensors

Entity	Device Class	Unit	Notes
Battery	battery	%
Battery temperature	temperature	°C	Scaled ÷10
Battery state	enum	—	idle / charging / discharging
Input power	power	W
Output power	power	W
Time to full	duration	h	Scaled ÷10
Time remaining	duration	h	Scaled ÷10
AC input power	power	W
Car input power	power	W
AC voltage	voltage	V	Scaled ÷10
AC frequency	frequency	Hz
AC power	power	W
AC power (secondary)	power	W
AC socket power	power	W
Error code	—	—	Diagnostic
Power mode battery	—	—	Diagnostic
Total temperature	temperature	°C	Diagnostic
System status	—	—	Diagnostic

Binary Sensors

Entity	Device Class	Notes
Wireless charging	battery_charging	On when active
Temperature alarm	problem	Diagnostic
Power alarm	problem	Diagnostic

Switches

Entity	Device Class	Notes
AC output	outlet
DC output	outlet
USB output	outlet
Car output	outlet
AC input	outlet
DC input	outlet
Super fast charge	—	Config
UPS mode	—	Config

Selects

Entity	Options	Notes
Light mode	off, low, high, sos
Charge speed	fast, mute	Config
Battery protection	full, eco	Config

Numbers

Entity	Range	Unit	Notes
Auto shutdown	0–24	hours	Config
Energy saving	0–24	hours	Config
Screen timeout	0–300	seconds	Config

Development

# Install dependencies
uv sync

# Run checks
uv run ruff check .
uv run ruff format --check .
uv run mypy .
uv run pytest