Troubleshooting
Start with:
tsm doctor
It checks the configuration, the connection, the login and the tenant of the selected context, and says which step fails.
| Problem | Check with | What to do |
|---|---|---|
| A command from this guide is unknown | tsm --version | Update the CLI: tsm cli upgrade |
| No context selected | tsm context list | Create a context and select it: tsm context use NAME --global |
| Wrong environment or tenant | tsm context show --explain | Pass --context / --tenant explicitly |
| Not logged in, HTTP 401 | tsm auth status | Log in again for that context: tsm --context NAME auth login |
| Token is for a different tenant | tsm context show --explain | Select the matching tenant, or log in for that tenant |
All checks above only read. When asking for help, include tsm --version, the selected context and
workspace, and the error output. Never attach API keys, passwords or tokens.
Problems with the experimental local runtime are covered in Local runtime troubleshooting.