PowerGuardian logo
PowerGuardian

Frequently Asked Questions

Everything you need to know about PowerGuardian.

Controller

What hardware is required?

The Controller runs on NanoPi R3S or Neo3 — compact ARM boards around €30. Any Linux ARM device with 512 MB RAM works.

How does the Controller discover devices?

It uses LLDP (Link Layer Discovery Protocol) to automatically detect PowerGuardian Connectors and other network devices on your subnet — no manual IP configuration needed.

How are credentials stored?

All secrets are stored in an encrypted vault using PBKDF2-SHA256 with 600,000 iterations (OWASP/NIST compliant). SNMP community strings and NUT passwords are encrypted at rest.

How do OTA updates work?

Push a new binary from the Controller dashboard to all connected Connectors in one click. The agent downloads it, replaces itself, and restarts automatically.

Can I manage multiple locations?

Yes. The Controller supports multi-site configurations — group Connectors by physical location and apply site-specific alert rules and thresholds.

Connector

What is a Connector and where does it run?

A lightweight Go agent that runs on any Linux device — Raspberry Pi Zero, router, or switch. It bridges your physical UPS to the Controller.

Which UPS protocols are supported?

NUT (Network UPS Tools) for USB/serial UPS devices, and SNMP RFC 1628 for enterprise networked UPS systems.

How does it communicate with the Controller?

Via a persistent WebSocket connection for real-time telemetry streaming and instant shutdown command execution.

Does it need a static IP?

No. LLDP discovery and WebSocket heartbeats let the Controller track the Connector even when the IP changes via DHCP.

What happens if the connection drops?

The Connector buffers critical events locally and reconnects using exponential backoff. No data is lost during brief network interruptions.

Cloud & Licensing

How do I log in?

Passwordless magic-link login. Enter your email, click the link we send you — no password needed, ever.

How does the cloud connect to my local Controller?

Via Cloudflare Tunnel — a secure outbound-only connection. No open ports or firewall rules required on your side.

How do I link my license to the Controller?

Go to Settings → License in the Controller UI, click Link License, enter your email, and enter the 6-digit code we email you.

What happens if my subscription ends?

Your Controller keeps running locally — nothing breaks immediately. The license status changes to expired and you can renew at any time from the pricing page.

Still have questions?

Check the docs or send us an email.