Encountering issues with AKR SecureShell 1.1.2? This troubleshooting guide is here to help. We’ve compiled solutions to the most common problems users face, from connection errors to authentication failures. Each troubleshooting item includes step-by-step instructions to resolve the issue quickly. By following these guidelines, you can minimize downtime and keep your remote server management running smoothly.
Troubleshooting
⚠️ AKR SecureShell fails to connect to the server
First, verify that the server is online and accessible by pinging the hostname or IP address from your Windows command prompt. If the server responds, check the profile settings in AKR SecureShell to ensure the hostname, username, and port are correct. If using key-based authentication, confirm that the private key is properly imported and the passphrase is correct. Also, ensure your firewall or antivirus isn’t blocking the SSH port (default 22).
⚠️ Connection times out or is unstable
A timeout issue can stem from network instability or server-side restrictions. Start by checking your internet connection and restarting your router if necessary. If the problem persists, increase the connection timeout in the profile settings (e.g., from 10 to 30 seconds). On the server side, ensure SSH is running and not being blocked by a firewall. You can also try connecting from a different network to isolate the issue.
⚠️ Authentication fails with incorrect password
If you’re sure the password is correct, double-check for typos or case sensitivity. If the issue persists, reset the password on the server and update it in the AKR SecureShell profile. For key-based authentication, ensure the private key is correctly imported and the public key is added to the server’s authorized_keys file. If using 2FA, verify that the one-time code is entered correctly.
⚠️ The console appears laggy or unresponsive
Lag in AKR SecureShell can result from high CPU usage or network latency. Close unnecessary applications to free up system resources, and check your task manager for processes consuming excessive CPU or memory. If the issue persists, reduce the font size or disable hardware acceleration in the software settings. A stable internet connection is also crucial for smooth performance.
⚠️ SSH keys are not working for authentication
If your SSH keys aren’t working, first ensure the private key is correctly imported into AKR SecureShell. The key should be in .ppk or .pem format. Next, verify that the corresponding public key is added to the server’s authorized_keys file. On Windows, you can use PuTTYgen to convert keys to the correct format. If the key is passphrase-protected, enter the passphrase when prompted during connection.
⚠️ Profiles are missing after reinstalling Windows
If you reinstalled Windows and lost your profiles, check if you backed up the configuration file (typically in 'C:\Users\<YourUsername>\AppData\Roaming\AKR SecureShell'). If you have a backup, copy the file to the same location on the new system. If not, you’ll need to recreate your profiles manually. To prevent this in the future, regularly export your profiles to a secure location.
⚠️ The software crashes or freezes on startup
A crash or freeze on startup may be caused by corrupted settings or a conflict with another application. Start by reinstalling AKR SecureShell to reset all configurations. If the issue persists, try running the software in compatibility mode (right-click the shortcut > Properties > Compatibility). Disable any third-party antivirus temporarily to check for conflicts. Ensure your Windows system is up to date with the latest patches.
⚠️ Copy-paste functionality isn’t working in the console
If you can’t copy or paste text in AKR SecureShell, ensure you’re using the correct keyboard shortcuts (Ctrl+C for copy, Ctrl+V for paste). If the shortcuts don’t work, check the software settings under 'Keyboard Shortcuts' to confirm they’re enabled. Alternatively, use the right-click context menu for copy-paste operations. If the issue persists, restart the software or your computer to reset the clipboard functionality.