Verify install
After install or reinstall, run the verify script from a checkout:
bash
npm run verify:installOr directly:
bash
./scripts/verify-local-install.shWhat it checks
- Installed tree exists under
~/.local/share/thirdflare-one thirdflare --versionsucceeds- Daemon starts with Web UI enabled (
THIRDFLARE_WEBUI=1) for health check GET /api/healthreturns OK- Stops the test daemon cleanly
Tray check
bash
thirdflare-one-tray --checkExit 0 when PyQt6 tray dependencies are importable and the StatusNotifier path is viable on your session.
Common fixes
| Symptom | Fix |
|---|---|
| 503 on health | Daemon started without Web UI; use npm run dev or set THIRDFLARE_WEBUI=1 |
| Stale UI / log dock | Purge reinstall; service worker cache bumps on release |
| Tray missing on KDE | Install PyQt6-WebEngine; log out/in after first install |