License Activation¶
Activating a license takes less than two minutes. After activation, Hanergy works fully offline -- no internet connection is needed for day-to-day operation.
Step-by-Step¶
1. Create an account¶
Visit cloud.hanergy.app and create an account with your email address and a password.
2. Get a license¶
- For a Free license: click "Get Free License" on the dashboard after logging in.
- For a Pro license: click "Buy Pro", complete the payment, and the license is generated automatically.
3. Copy the license token¶
After the license is created, a token string is displayed on your account page. Copy it to your clipboard.
4. Activate in Hanergy¶
- Open the Hanergy UI in Home Assistant.
- Go to Settings > License.
- Paste the token into the license field.
- Click Activate.
Hanergy validates the token and applies the corresponding tier immediately. The dashboard will reflect the new device and priority limits.
5. Verify¶
Go to Settings > License to confirm the active tier, device limit, and priority limit. The information displayed should match your purchased tier.
How It Works¶
The license token is a cryptographically signed string that encodes your tier, device limits, and update window. Hanergy validates the signature locally using the embedded public key -- no network call is needed.
This means:
- Activation requires internet (one time, to download the token from cloud.hanergy.app).
- All subsequent operation is offline. The token is stored locally and validated on each startup without contacting any server.
- Reinstalling the add-on preserves the license as long as the Hanergy configuration directory is intact (the default volume mount handles this automatically).
Note
If you reinstall Home Assistant or lose the configuration directory, you will need to re-paste the license token from your cloud.hanergy.app account. The token itself does not expire -- only the update window determines which releases it covers.