ShortIQ

ShortIQ

DevOps

How to Use a PPK File in PuTTY

A practical Windows guide to using a PPK file in PuTTY for SSH access, including session setup, host configuration, and common connection mistakes.

April 28, 2026ShortIQ Editorial Team

Advertisement

What a PPK File Is

A PPK file is PuTTY’s private key format. If you are connecting to a Linux server or AWS EC2 instance from Windows using PuTTY, this is the file format PuTTY expects for key-based SSH access.

Many hosting providers and cloud platforms give you a PEM file first. If you use PuTTY, you often convert that PEM file into a PPK file with PuTTYgen before trying to connect.

What You Need Before Connecting

Before using a PPK file in PuTTY, make sure you have the target server IP or hostname, the correct SSH username, and the private key file already converted into PPK format. You also need PuTTY installed on your Windows machine.

For AWS EC2, the username depends on the image you launched. Common examples include ubuntu, ec2-user, admin, and root, depending on the server setup.

  • PuTTY installed
  • A valid `.ppk` private key file
  • Server IP address or public DNS
  • Correct SSH username
  • Port 22 open in the server firewall or security group

How to Load the PPK File in PuTTY

Open PuTTY and enter the server IP or hostname in the Host Name field. Leave the port as 22 unless your server uses a custom SSH port. Then, in the left sidebar, expand Connection, expand SSH, and click Auth.

In the Auth section, look for the private key file field and browse to your PPK file. Select it, then go back to the Session tab. At that point, you are ready to connect or save the session for later use.

  • Open PuTTY
  • Enter server IP or hostname
  • Go to Connection > SSH > Auth
  • Browse to your `.ppk` file
  • Return to Session and click Open

How to Save the Session

If you will connect regularly, save the session so you do not have to re-enter the server host and key file path every time. In the Session section, enter a name under Saved Sessions and click Save.

This is especially helpful if you manage multiple servers from Windows and want each one to keep its own key association and host settings.

What Happens on First Connection

The first time you connect, PuTTY may show a server host key warning. This is normal when the host has not been seen before on your machine. Verify that the server is the one you expect, then accept the key and continue.

After that, PuTTY will open the terminal session and prompt you for the username if it was not already supplied in the session settings.

Common Errors and Fixes

Most PuTTY SSH problems are caused by the wrong username, a server firewall issue, or the wrong private key. If PuTTY says access denied or authentication failed, double-check that the PPK file matches the server and that you are using the correct login user.

If PuTTY times out, confirm that the server is running, reachable publicly, and allowing inbound SSH on port 22 or your custom port.

  • Authentication failed: wrong key or wrong username
  • Connection timed out: port 22 blocked or server unreachable
  • Network error: hostname not found: wrong IP or DNS
  • Server refused our key: the matching public key is not authorized on the server

Converting PEM to PPK Before Using PuTTY

If your cloud provider gave you a PEM file — which is common with AWS EC2 key pairs and many managed VPS services — you need to convert it to PPK before PuTTY can use it. PuTTYgen handles this conversion and ships alongside PuTTY in the same download package.

Open PuTTYgen and click Load. Change the file filter to show all files so the PEM file appears in the browser. Select the file, and PuTTYgen will read the key and display its type and fingerprint. Click Save private key and choose a location for the resulting PPK file. You can then load this PPK file into PuTTY using the Auth steps described above.

If you plan to connect to the same server frequently, save the PuTTY session after loading the PPK file. This stores the host settings and key file path together so you can reconnect with a single click from the session list. Keeping the original PEM file alongside the PPK is good practice in case you later switch to OpenSSH or a different SSH client on another machine.

  • Open PuTTYgen and click Load
  • Change the file filter to "All Files" so .pem files appear
  • Load the PEM file and click Save private key
  • Use the resulting PPK file in PuTTY Connection > SSH > Auth

SSH Usernames for Common Server Environments

One of the most frequent causes of PuTTY authentication failure is using the wrong SSH username. The username is set by the server image, not the key file. A correct PPK file combined with the wrong username produces an "Access denied" error every time, regardless of whether the key itself is valid.

For AWS EC2, the correct username depends on the AMI. Ubuntu images use ubuntu. Amazon Linux and Amazon Linux 2 use ec2-user. Debian images use admin. CentOS images typically use centos or ec2-user. RHEL images use ec2-user. Bitnami-based images use bitnami. If you launched a custom AMI or a marketplace image, check the product documentation or the instance console output for the expected login user.

For non-AWS servers, the username is usually set by your hosting provider. Most DigitalOcean, Linode, and Vultr droplets use root for fresh Ubuntu deployments. Managed panel hosts often use a custom username tied to the account. When in doubt, check the welcome email or the server console in your hosting dashboard — the correct username is almost always documented there.

  • AWS Ubuntu: ubuntu
  • AWS Amazon Linux: ec2-user
  • AWS Debian: admin
  • AWS CentOS / RHEL: centos or ec2-user
  • DigitalOcean / Linode / Vultr (fresh Ubuntu): root
  • Bitnami marketplace images: bitnami

Saving Multiple PuTTY Sessions for Different Servers

If you regularly connect to more than one server from Windows, saving separate PuTTY sessions for each one significantly reduces setup friction. Each session stores the hostname, port, SSH username (if configured under Connection > Data > Auto-login username), and the path to the PPK private key file. You load the session from the list and connect immediately.

To update a saved session after changing a server IP or swapping key files, load the session, make the changes in the appropriate sections, return to the Session tab, and click Save again with the same session name. PuTTY overwrites the existing record.

For teams that manage many servers, organizing session names by environment — for example, prod-api, staging-db, dev-web — makes the PuTTY session list easier to navigate. Naming sessions consistently also reduces the risk of accidentally connecting to the wrong environment during maintenance.

Related SSH and Key Guides

If you still have a PEM file instead of a PPK, start with the PEM-to-PPK conversion guide first. If you are using AWS EC2 from Windows, the EC2 SSH tutorial is the best companion article because it explains usernames, security groups, and host key details in context.

  • Related article: /blog/convert-pem-to-ppk
  • Related article: /blog/how-to-ssh-into-aws-ec2-from-windows
  • Related article: /blog/how-to-convert-ppk-to-pem
  • Blog hub: /blog

FAQ

What is a PPK file used for?

A PPK file is PuTTY’s private key format and is used to authenticate SSH connections from PuTTY on Windows.

Can I use a PEM file directly in PuTTY?

Usually no. PuTTY typically expects a PPK file, so you often need to convert PEM to PPK first using PuTTYgen.

Where do I load the PPK file in PuTTY?

In PuTTY, go to Connection, then SSH, then Auth, and browse to the PPK file in the private key field.

Why does PuTTY say authentication failed?

The most common causes are the wrong SSH username, the wrong private key, or the matching public key not being authorized on the server.

Can I save the PPK configuration in PuTTY?

Yes. You can save the host and key settings as a named session from the Session tab.

Related free tools

If you want to turn this topic into action, use one of ShortIQ's free tools for campaign planning, UTM structure, or QR distribution.

Continue Reading

Explore more guides on link shortener SaaS strategy, Bitly alternatives, and white label link management.

Free newsletter

Get new guides in your inbox

We publish practical guides on dev tooling, prompt engineering, marketing workflows, and deployment. No fluff — straight to the point.

No spam. Unsubscribe any time.

Was this article helpful?

Tell us if this guide solved the problem or what was still missing. We use this to improve the blog and only follow up if you explicitly allow it.

We use this to improve tutorials, examples, and technical depth.