Troubleshooting & Diagnostics
DocsSupport & TroubleshootingTroubleshooting & Diagnostics

Troubleshooting & Diagnostics

Actionable steps and diagnostics for resolving network, certificate, and installation issues.

Whenever you encounter unusual network disconnects or configuration issues, start with our automated diagnostic utility:

ksp doctor --verbose

Common Resolutions

  • Port Already in Use (`os error 98` / `10048`): Another service is bound to your target port. Use ksp doctor or bind to a custom port via --bind 127.0.0.1:0.
  • Handshake Timeout: Verify that your local firewall (Windows Defender / `iptables`) allows inbound UDP/TCP traffic on port `9876`.