Skip to main content

Troubleshooting

Documentation Map​

Troubleshooting

http://<internal-runtime-redacted>:18180/healthz does not answer​

Run:

.\scripts\start-local-audio-runtime.ps1 -ForceRestart -WaitForReady
.\scripts\get-runtime-status.ps1

Then inspect:

  • %LOCALAPPDATA%\JHF-Tenter\local-audio-runtime\runtime.stdout.log
  • %LOCALAPPDATA%\JHF-Tenter\local-audio-runtime\runtime.stderr.log

Tray shows Audio missing​

The tray is the owner, but the local audio server may still be cold or failed.

Actions:

  1. refresh the tray
  2. run .\scripts\start-local-audio-runtime.ps1
  3. confirm get-runtime-status.ps1 reports installed=true

Tray shows Audio warming​

This means the local Voxtral STT model is still loading.

Wait for the next refresh cycle and verify:

.\scripts\get-runtime-status.ps1

Tray shows Audio degraded​

Current expected degraded cases include:

  • STT is live but TTS is not yet self-hosted on this host
  • the server surfaces are alive but a required model path is not fully available

Read back:

  • GET /healthz
  • GET /models
  • GET /metrics/latency

Legacy Boundary​

This runbook no longer documents Ollama as the active Windows voice path.

Historical Ollama / local Mistral notes belong to legacy maintenance context only.

AGPLv3. See ../LICENSE (LICENSE). Learn more at helpifyr.com.