Skip to content

Verify install

After install or reinstall, run the verify script from a checkout:

bash
npm run verify:install

Or directly:

bash
./scripts/verify-local-install.sh

What it checks

  1. Installed tree exists under ~/.local/share/thirdflare-one
  2. thirdflare --version succeeds
  3. Daemon starts with Web UI enabled (THIRDFLARE_WEBUI=1) for health check
  4. GET /api/health returns OK
  5. Stops the test daemon cleanly

Tray check

bash
thirdflare-one-tray --check

Exit 0 when PyQt6 tray dependencies are importable and the StatusNotifier path is viable on your session.

Common fixes

SymptomFix
503 on healthDaemon started without Web UI; use npm run dev or set THIRDFLARE_WEBUI=1
Stale UI / log dockPurge reinstall; service worker cache bumps on release
Tray missing on KDEInstall PyQt6-WebEngine; log out/in after first install

Unofficial client — not affiliated with Cloudflare.