sodcalculator

10 Tech How-To

Install PuTTY on Mac: Easy Step-by-Step Guide

Guide 10-49248 · Updated · Step by step

To install PuTTY on a Mac, the simplest method is to use Homebrew: open Terminal and run brew install putty. This installs the command-line tools (putty, pscp, psftp) and the graphical SSH client, which you can launch by typing putty in Terminal. If you prefer not to use Homebrew, you can download the official macOS binaries from the PuTTY website or compile from source, but Homebrew is the fastest and most reliable for most users.

What Is PuTTY and Why Use It on macOS?

PuTTY is a free, open-source terminal emulator and network client originally written for Windows. It supports SSH, Telnet, and raw socket connections, making it a popular tool for remote administration of servers and network devices. On macOS, the built-in Terminal app already includes an SSH client (ssh command), so many users never need PuTTY. However, PuTTY offers a graphical interface that some prefer, and it includes tools like pscp (secure copy) and psftp (FTP over SSH) that can be handy in scripts. It also supports saved sessions, key-based authentication, and port forwarding, which can be more convenient than remembering long command-line options.

Prerequisites: What You Need Before Installing

  • macOS version: PuTTY works on macOS 10.13 (High Sierra) and later; the official binaries are compiled for 64-bit Intel and Apple Silicon (M1/M2) via Rosetta 2.
  • Homebrew (recommended): If you don’t have Homebrew, install it by running the command from brew.sh (it requires Xcode Command Line Tools, which macOS will prompt you to install).
  • Internet connection: You’ll need to download the installer or use Homebrew to fetch the package.
  • Administrator privileges: Homebrew installs to your user directory, so no admin password is needed, but the official .pkg installer may ask for your password.

Method 1: Install PuTTY via Homebrew (Recommended)

  1. Open Terminal (found in /Applications/Utilities/).
  2. Install Homebrew if you haven’t already: /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  3. Update Homebrew: brew update
  4. Install PuTTY: brew install putty
  5. Verify the installation: putty --version (should print version info).
  6. Launch PuTTY by typing putty in Terminal, or use pscp and psftp from the command line.

Homebrew installs the latest stable version and automatically handles dependencies. It also makes updating easy: brew upgrade putty.

Method 2: Install from Official Binaries

If you prefer not to use Homebrew, you can download the macOS installer from the official PuTTY website (www.chiark.greenend.org.uk/~sgtatham/putty/latest.html). Look for the .pkg file for macOS. Double-click the downloaded file and follow the installer prompts. This will install PuTTY and its associated tools to /usr/local/bin. After installation, you can launch PuTTY from the Applications folder or via Terminal. Note that the official binaries may not be updated as frequently as Homebrew, and you’ll need to manually check for updates.

Method 3: Compile from Source (Advanced)

For those who want the absolute latest version or need custom compilation flags, you can build PuTTY from source. Download the source tarball from the official site, extract it, and run ./configure && make. This requires Xcode Command Line Tools and possibly additional libraries (like GTK for the GUI). This method is time-consuming and not recommended for most users, as the pre-built binaries are usually sufficient.

How to Use PuTTY on Mac

Once installed, you can launch PuTTY by typing putty in Terminal. The GUI looks similar to the Windows version: you enter the hostname or IP address, select the connection type (SSH, Telnet, etc.), and click Open. If you’re using the command-line tools, here are common commands:

  • putty -ssh user@example.com – opens an SSH session directly.
  • pscp file.txt user@example.com:/remote/path – copies a file to a remote server.
  • psftp user@example.com – starts an interactive SFTP session.

To save a session for quick access, fill in the fields, give it a name under “Saved Sessions”, and click Save. You can also set up SSH key authentication by generating keys with puttygen (included) and loading the private key in the connection settings.

Common Issues and Troubleshooting

  • “command not found” after Homebrew install: This usually means /usr/local/bin (or /opt/homebrew/bin on Apple Silicon) isn’t in your PATH. Add it by editing your shell profile (e.g., export PATH="/opt/homebrew/bin:$PATH" in ~/.zshrc).
  • PuTTY won’t open on Apple Silicon: The official binaries are universal, but if you compiled from source, ensure you have the right architecture. Homebrew installs the correct version automatically.
  • Connection refused or timeout: Check your network, firewall, and that the remote server is running SSH on the expected port (default 22).
  • Host key verification failed: This happens when the server’s key changes. You can remove the old key with ssh-keygen -R hostname (if using OpenSSH) or in PuTTY, delete the cached key from the registry.
  • Copy/paste issues: In PuTTY on Mac, copying is done by selecting text with the mouse (it auto-copies), and pasting is done by right-clicking or pressing Shift+Insert (or Cmd+V in some versions).

Comparing PuTTY to macOS Built-in SSH

macOS includes OpenSSH, which provides the ssh, scp, and sftp commands in Terminal. For most users, the built-in SSH is sufficient and more integrated with the system (e.g., it uses the macOS keychain for passwords). PuTTY’s advantages are its graphical interface, saved sessions, and some advanced features like SSH tunneling presets. However, OpenSSH is more scriptable and is the de facto standard on Unix-like systems. If you’re comfortable with the command line, you may not need PuTTY at all. If you prefer a GUI, PuTTY is a solid choice, but there are also other Mac-native SSH clients like Termius or Royal TSX that offer more polish.

Frequently Asked Questions

Do I need to install X11 or other dependencies?

No. The official PuTTY binaries and Homebrew package are self-contained. They do not require X11, as PuTTY uses its own GUI toolkit (GTK is bundled in the Homebrew package). If you compile from source, you may need GTK, but the standard installs are ready to run.

Can I use PuTTY to connect to a serial port on Mac?

Yes, PuTTY supports serial connections. In the connection type, select “Serial” and specify the serial line (e.g., /dev/tty.usbserial-XXXX) and baud rate. This is useful for configuring network switches or routers via console cable.

How do I uninstall PuTTY?

If you installed via Homebrew, run brew uninstall putty. If you used the .pkg installer, you can remove the files manually or use a third-party uninstaller. The files are typically in /usr/local/bin and /Applications/PuTTY.app (if present).

Is PuTTY free and safe to use?

Yes, PuTTY is completely free and open-source (MIT license). It has been widely used for decades and is considered safe. Just download it from the official website or via Homebrew to avoid malicious copies.

Why does PuTTY show a “Network error: Connection timed out”?

This usually means the remote host is unreachable. Check your internet connection, the hostname/IP, and that the SSH service is running on the remote server. Also ensure your firewall isn’t blocking outbound port 22.

Can I use PuTTY to generate SSH keys on Mac?

Yes, PuTTY includes puttygen, which you can run from Terminal. It generates RSA, DSA, ECDSA, and Ed25519 keys in PuTTY’s .ppk format. You can also convert OpenSSH keys to .ppk format with puttygen.

Related

General steps for current mainstream versions; menus can differ by device and version. See the disclaimer or report an error.

More in this bed

The whole Tech How-To bed →