# CLI troubleshooting

Authentication issues
- Verify Backend.BaseUrl and Authority reachability.
- Re-login when tokens expire or scopes are missing.
- Use API key auth for headless automation when allowed.

Crypto provider issues
- Ensure the correct regional build is installed.
- Verify provider configuration and key container paths.
- Use crypto profiles diagnostics to test provider health.

Build and distribution issues
- Confirm the expected build flags for regional plugins.
- Validate distribution metadata using stella --version.

Scanning and network issues
- Confirm registry access and offline cache settings.
- Use offline bundles when network is restricted.

Permissions and scopes
- Ensure the token includes required scopes for admin or policy commands.

Related references
- docs/cli/troubleshooting.md
- docs2/cli/crypto.md