Skip to content

FAQ Troubleshooting

Damien edited this page Oct 18, 2026 · 1 revision

❓ FAQ & Troubleshooting

The UI won't launch or looks broken.

Force the software renderer by setting ICED_BACKEND=tiny-skia and then running WattSeal from the terminal. WattSeal also retries with this automatically if the default renderer fails on Windows.

CPU power looks like a rough guess, not a real reading.

You're running without admin (Windows) or root (Linux), or you're on macOS. See Platform Support.

No tray icon on Linux.

Install libappindicator or libayatana-appindicator. Without either, WattSeal runs without one, reopen the dashboard by re-running the executable.

Where's my data stored?

power_monitoring.db, SQLite, next to the executable. Nothing leaves your machine unless you set up MQTT.

Where are the logs?

collector.log next to the executable.

Closing the window stops the app?

No, it keeps running in the background/tray. Pick "close everything" in the close dialog, or use the tray menu, to fully exit.

Can I run it on a headless server?

Yes, use --headless. See CLI Reference.

GPU shows no data.

NVIDIA, AMD, and Intel GPUs are supported, see Platform Support.

How do I uninstall?

Delete the executable and power_monitoring.db. On Windows, if you installed the CPU driver, remove it first as Administrator: WattSeal-windows.exe --uninstall-cpu-driver.

Clone this wiki locally