PuTTY is a widely used SSH client for accessing remote servers securely. However, many users encounter issues with PuTTY not working on Ubuntu 22.04 and other Linux distributions after installation. This guide provides step-by-step solutions to troubleshoot and fix PuTTY issues effectively.
In this blog post, we will explore common problems users face and provide troubleshooting steps to resolve them, ensuring a seamless PuTTY experience on your Ubuntu system.
Common Issues with PuTTY on Ubuntu 22.04
- PuTTY Not Launching: The application does not open after installation.
- PuTTY Command Not Found: The terminal does not recognize the putty command.
- Connection Refused: Unable to connect to the remote server.
- Authentication Failure: SSH keys or credentials are not working.
- PuTTY Freezing or Crashing: The session freezes unexpectedly.
- PuTTY X11 Forwarding Not Working: GUI applications fail to open.
Step-by-Step Fixes
1- Verify Installation
Ensure that PuTTY is installed correctly by running:
which puttyIf the output is empty, install PuTTY with:
sudo apt update && sudo apt install putty2- Check If PuTTY Is Installed Properly
Run:
dpkg -l | grep puttyIf PuTTY is not listed, reinstall it
sudo apt remove putty && sudo apt install putty3- Launch PuTTY via Terminal
Try launching PuTTY manually:
puttyIf it does not start, check logs for errors:
dmesg | grep putty4- Fix Connection Refused Error
Ensure the remote server is reachable:
ping <remote-server-ip>Check if SSH is running on the remote server:
ssh <remote-server-ip>If SSH is not running, start it with:
sudo systemctl start ssh5- Resolve Authentication Issues
If login fails, ensure SSH keys are correctly set up:
ssh-keygen -t rsa -b 4096
ssh-copy-id user@remote-serverModify PuTTY settings:
> Navigate to Connection > SSH > Auth.
> Load the correct private key.
6- Fix PuTTY Freezing
Check system logs:
journalctl -xeEnsure no other processes are using excessive CPU:
stopTry running PuTTY with
strace putty7- Enable X11 Forwarding
- In PuTTY, go to Connection > SSH > X11.
- Check Enable X11 Forwarding.
- Ensure the remote server has xauth installed:
sudo apt install xauth x11-xserver-utilsStart an X server on your local machine:
export DISPLAY=:0PuTTY Advance Troubleshooting
I guess in Ubuntu 22.04 normally used putty version 0.76 with default fonts (“Server.fixed”).
Go to Putty Configuration –> Window –> Fonts.
Define as ‘Font used for ordinary text’ another font that is listed and previewed without problem (eg Ubuntu Mono).
