Troubleshooting

Common Issues

Authentication Problems

"Authentication failed" or "Invalid API key"

Symptoms: - Commands return authentication errors - hcli whoami fails

Solutions: 1. Verify your API key:

hcli whoami

1. Re-authenticate:

   hcli logout
   hcli login
   

2. Check environment variables:

   echo $HCLI_API_KEY
   

"Unable to reach authentication server"

Symptoms: - Login process hangs or times out - Network connectivity errors

Solutions: 1. Check internet connection 2. Verify proxy settings if behind corporate firewall 3. Try alternative authentication method (API key vs OAuth)