Troubleshooting

Diagnose a Subshell problem from its observable symptoms.

Start with diagnostics

On a server host:

subshell-server status
subshell-server service status

On an enrolled node:

subshell status
subshell service status

Capture the component version, exact error, and whether the problem occurs in a browser, desktop window, or host command. Do not include credentials in your report.

Choose a symptom

• Installation errors covers downloads, initialization, and missing binaries.
• Sign-in and origin errors covers authentication addresses and providers.
• Node troubleshooting covers connectivity and refused versions.
• Agent and launch errors covers detection, directories, and startup.
• Terminal troubleshooting covers input, streaming, and geometry.
• Notification troubleshooting covers browser delivery.
• MCP troubleshooting covers tools, credentials, and channels.
• Update troubleshooting covers updater and container behavior.

Report an issue

Read Support and releases for public issues and private security reporting. FAQ answers common setup questions.