Troubleshooting
Pick the area closest to what is failing. Every guide below lives beside the feature it covers, so none of this is a second copy that drifts from the first.
Connecting
| A connection is refused | Connection Denied |
| A login hangs instead of refusing | Login Approvals — a key waiting to be approved |
| Sessions from a legacy namespace behave differently | Upgrading a Legacy Namespace |
Devices
| A device never showed up | Device Not Appearing |
| It arrived pending instead of accepted | Provisioning Keys — the key’s mode decides |
| A device came back that you deleted | Device Not Appearing |
Signing in
| SAML fails | SAML Sign-In Fails — check the license first |
| Somebody cannot see a device | User Roles |
Your own server
| The stack will not come up, or a service is unhealthy | Troubleshooting |
| Certificates, the database, the gateway | Troubleshooting |
| It broke after an upgrade | Upgrade |
Automation
| A playbook or pipeline hangs at connect | The API key has no SSH key enrolled yet. SSH Access |
| A generated client returns 404 | The spec was the wrong edition. the specification |
Still stuck
Getting Support has where to ask, what to include so the first answer is useful, and what to redact before pasting.