EN | JA

Operations overview

Day-2 operations in kanade fall into two flows:

  1. Direct install — drop binaries + config on a fresh host and register the Windows service. Used to bootstrap the first agent, the initial backend, and the NATS server. Scripts: scripts/deploy/agent.ps1, scripts/deploy/backend.ps1, scripts/deploy/nats.ps1. Run manually on the target host.

  2. Agent-mediated update — once an agent is running, the agent itself can install / update other components on its own host without ssh / RDP. The operator publishes binaries + script bodies to the broker, then fires a job; the agent fetches, verifies, swaps, and restarts services. This is the bulk of day-2 operations.

The agent-mediated flow has the same shape regardless of what you're updating:

operator host ─► kanade CLI ─► backend HTTP API ─► NATS ─► agent
                    │                              │
                    ├── publish binary ────────────► fetches from
                    │   to OBJECT_APP_PACKAGES        OBJECT_APP_PACKAGES
                    ├── publish script ────────────► fetches from
                    │   to OBJECT_SCRIPTS             OBJECT_SCRIPTS
                    ├── register / update job ─────► reads job manifest
                    │                                 from `jobs` KV
                    └── exec job ──────────────────► PowerShell child
                                                      runs the script

The diagram shows the Windows installer jobs. Linux has bundle/setup scripts and cross-platform agent rollout; see Linux deployment and macOS agent deployment.

Component-specific guides:

  • kanade-backend — the HTTP / projector binary
  • kanade-client — the Tauri end-user app
  • NATS server — the broker itself (yes, you can update the broker over the broker)
  • kanade-agent itself — the agent self-update path (different from the other three; it uses a dedicated rollout bucket, not the generic OBJECT_APP_PACKAGES + script pair)

Enabling passkey sign-in

Use Operator Settings → Server Settings → Passkeys to configure and enable WebAuthn. This is the only supported configuration path; passkeys are disabled by default. Enter the externally trusted RP ID and HTTPS origins explicitly, save, and check the effective state. Updates apply without a restart and invalidate pending ceremonies across backend instances. See configuration reference for validation rules, credential management and multi-instance routing requirements. Existing password/TOTP login and recovery continue to work.