Skip to content

Dashboard

Jump to bottom
krisjanisp edited this page Oct 9, 2026 · 1 revision

Dashboard

qkd-stub-gui is a second executable that shows a saved configuration and live client activity. It is built with the gui Cargo feature (cargo build --release --locked --features gui) and is shipped, signed, in the Windows release next to qkd-stub.exe. The command-line tool remains the only way to provision (see Standalone provisioning).

.\qkd-stub.exe demo init
.\qkd-stub-gui.exe --config qkd-demo/a.toml --start

Tabs: Status (settings, the check results, Start/Stop), SAEs, Certificates (server chain and trusted client CAs), and Activity (time in UTC, authenticated SAE, method, route, status, duration).

  • The dashboard serves the configuration inside its own process with the same code as qkd-stub serve; closing the window stops the server. It cannot show activity of a separately started qkd-stub serve.
  • Activity is kept in memory (latest 1000 requests). Each event holds only the matched route template, never query strings, bodies, key IDs, or key material.
  • Failed TLS handshakes never reach the HTTP layer and are not shown.
  • The PSK and private keys are never displayed.
  • Rendering needs OpenGL 2 or later; remote or virtual sessions with only basic software rendering may be unable to open the window.

Details: docs/gui.md.

Clone this wiki locally