Troubleshooting

Fix SSH and Telnet sessions that time out, fail authentication, stop at a host-key prompt, or fail through a jump host. Covers standalone Terminal and connections made through a NetStacks Controller.

Fix master password and vault unlock problems in the standalone Terminal, Touch ID issues, and sign-in errors on the NetStacks Controller (wrong password, lockout, license seats, idle sign-out, lost admin password).

Fix an AI assistant that is not configured, cannot reach its provider, is rate limited, will not run commands, or is managed by a Controller. Covers Anthropic, OpenAI, OpenRouter, Ollama, LiteLLM and custom endpoints.

Fix the Terminal's Cannot Connect screen, untrusted or changed Controller certificates, and certificates that do not cover the Controller's address. Includes manual CA install commands for macOS, Windows and Linux.

Check the health of a NetStacks Controller, read its container logs, and fix common install, startup, upgrade, jumpbox and license-activation problems.

Keep NetStacks responsive with many tabs and long outputs: scrollback, AI background features, hover lookups, live topology polling, large file transfers, and Controller session limits.

Where the NetStacks desktop app keeps its files on macOS, Windows and Linux, how to see the local agent's output, how to recover when the local agent will not start or the app is stuck in Controller mode, and what to send when asking for help.

Answers to common questions about NetStacks Terminal and the NetStacks Controller: platforms, modes, data storage, privacy, updates, credentials, protocols, AI providers, backups and licensing.