Hej Shell← Back to Home

Authentication Issues

Resolve login and authentication problems

Permission Denied

Permission denied error

Possible Causes

  • •Wrong username or password
  • •SSH key not registered on server
  • •SSH key permission issues
  • •Password authentication disabled

Solutions

  1. Verify username and password again
  2. Check if SSH key is in server's ~/.ssh/authorized_keys
  3. Check local key file permissions: chmod 600 ~/.ssh/id_rsa
  4. Confirm authentication method with server admin

Invalid Password

Password authentication failed

Solutions

  1. Check if Caps Lock is on
  2. Verify keyboard layout
  3. Type password in notepad first to verify
  4. Request password reset from server admin

SSH Key Issues

Resolve various issues related to SSH key authentication.

Key Not Accepted

SSH key authentication failed

Possible Causes

  • •Public key not registered on server
  • •Key file permission issues
  • •Wrong key format
  • •Key authentication disabled on server

Solutions

  1. Verify correct key is selected in HejShell
  2. Check server's ~/.ssh/authorized_keys file
  3. Verify PubkeyAuthentication yes in server's sshd_config
  4. Check server's .ssh folder permissions: chmod 700 ~/.ssh

Key Passphrase Error

The passphrase set for the SSH key is incorrect.

  1. Verify you entered the passphrase correctly
  2. If you forgot the passphrase, you need to generate a new key pair

HejShell Account Issues

Forgot HejShell Password

  1. Click 'Forgot Password?' on login screen
  2. If you have recovery key, reset password with recovery key
  3. If no recovery key, contact customer support

Recovery Key Not Working

Recovery key authentication failed

Possible Causes

  • •Word order is wrong
  • •Spelling errors
  • •Using recovery key from different account

Solutions

  1. Verify all 24 words are in correct order
  2. Check spelling of each word
  3. Case is not sensitive
  4. If issue persists, contact customer support

New Device Not Trusted

Logging in from a new device requires approval from an existing trusted device.

  1. Open app on a device you're already logged into
  2. Check push notification or go to Settings > Account > Devices for pending requests
  3. Review request info and approve

Two-Factor Authentication Issues

Issues when 2FA is set up on the SSH server.

Authentication Code Not Working

  • •Verify device time is accurate (NTP sync)
  • •Enter code quickly (changes every 30 seconds)
  • •Try using backup codes
  • •Ask server admin to reset 2FA

💡 Tips to Prevent Auth Issues

  • •Use a password manager recommended
  • •Backup SSH keys in a secure location
  • •Always store recovery key offline
  • •Change key passphrase regularly

Still Having Issues?

If the above methods don't resolve the issue, please contact us with detailed information. dev@hej.ai.kr

Hej Shell | Hej Shell