October DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsSlow PC?RecommendedPC slow today? Run a repair scan before it gets worseResolve common Windows issues and optimize system performance.Scan NowOctober DealsAmazon USDeal season is back - check today's better picksAmazon US: current deals, useful picks and tech finds.See Picks×
Skip to content
VGSources
Blog

How to Log In to a Linux Server With a PPK Key File

A PPK is PuTTY’s private-key format. Learn how to convert it for Linux OpenSSH, authorize the matching public key, connect with ssh -i, and fix common permission and account errors.
Length9 min Posted Quest giverVGSources Team
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

A .ppk file is PuTTY’s native private-key format. On Linux, the standard OpenSSH client may not read it directly, so install the PuTTY tools, convert the key to OpenSSH format, protect the converted file, and connect with ssh -i. The server must contain the matching public key in the target account’s ~/.ssh/authorized_keys.

What a PPK file is—and why Linux may need a conversion

PPK means PuTTY Private Key. It is the native private-key format used by PuTTY and related tools. OpenSSH, the SSH client normally used from a Linux terminal, may require a private key in an OpenSSH-compatible format instead. A format error does not necessarily mean the key is damaged; it often means the client and file formats do not match.

As an Amazon Associate I earn from qualifying purchases.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Converting a PPK creates an OpenSSH private-key file for the Linux client. The conversion does not by itself authorize an account. Authentication succeeds only when the server has the corresponding public key in the authorized_keys file of the account you are trying to log into.

Keep the original PPK as a protected backup. Treat both it and the converted private key as secrets: never paste either into a public issue, chat, ticket, or server configuration file.

#1 Best Overall
Sale
Gaoye Blue Light Blocking Glasses
  • BLUE LIGHT BLOCKING GLASSES: Our blue light glasses for women boast UV400 protection, blocking harmful blue rays from computer screens. With these bluelight glasses women, you can enjoy gaming, reading, or watching TV with no worries of eye strain.
  • EYE RELIEF: Our blue light glasses are engineered to reduce blurry vision or strain caused by prolonged screen time. These womens blue light glasses aid in better sleep by preventing blue light from disrupting your natural sleep cycle, helping you fall asleep faster and enjoy a more restful night's sleep, making them the perfect christmas present.
  • COMFORTABLE: Crafted from durable material, our trendy blue light glasses for woman or blue light glasses men ensure long-lasting comfort. The high-transmittance lenses accessories, gamer gifts for men, help keep your eyes relaxed. Perfect stocking stuffers, gifts for gamers men, christmas gifts for men, halloween costumes.
  • LIGHTWEIGHT: These clear blue light glasses feature a lightweight frame, meaning they’ll stay comfy for long-term wear. Perfect as blue blockers glasses for women or mens blue light glasses, these non-prescription fake glasses for men can be worn throughout the day. The blue light blocking glasses women feature polycarbonate HD lenses, which are anti-reflective and restore true color.
  • WORRY-FREE PURCHASE: If you experience any issues, our support team is ready to assist you quickly. These are the perfect costume glasses for cosplay dressing up.

What you need before connecting

  • A Linux computer with an SSH client and permission to install the distribution’s PuTTY tools package.
  • The PPK file and, if it is protected, its passphrase.
  • The server hostname or IP address and the SSH port if it is not the default SSH port.
  • The exact username of the account whose public key is authorized on the server.
  • An existing way to reach the server, such as a console or another login, if you still need to install the public key.

Do not assume that a key authorized for one account works for another. A key installed for alice is not automatically valid for a login as bob.

Prepare the server with the matching public key

Public-key authentication uses a key pair. You keep the private half on your computer; the server stores the public half. The public key must be a complete OpenSSH public-key line in the target account’s ~/.ssh/authorized_keys file.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Extract the OpenSSH public-key line

From a system with the PuTTY tools installed, run:

puttygen keyfile.ppk -L

Copy the complete OpenSSH public-key output as one line. Do not copy a proprietary display, a fingerprint line, or a partial selection from another PuTTYgen field.

Install it for the intended account

  1. Use an existing login or a server console to access the target account.
  2. Create the account’s ~/.ssh directory if it does not exist.
  3. Open or create ~/.ssh/authorized_keys and paste the entire public-key line on its own line.
  4. Save the file without wrapping, truncating, or altering the key text.
  5. Check that the home directory, .ssh directory, and authorized_keys file are owned by the target account and have restrictive permissions.

PuTTY documentation records this hardening command:

chmod go-w $HOME $HOME/.ssh $HOME/.ssh/authorized_keys

That removes group and other write permission from the relevant paths. The private key on your client is commonly protected with mode 600, which allows only its owner to read and write it.

Rank #2
Windex Gaming Cleaning Wipes, Pre-Moistened Wipes to Instantly Clean all Gaming Gear and Electronics, Resealable Packaging for a Freshness Lock, 25 count (Pack of 1)
  • WINDEX GAMING WIPES: effortlessly clean all your gaming gear and gaming electronics in one easy step with our new Windex Gaming Wipes
  • AMMONIA FREE: our ammonia-free formula is safe to use on all of your favorite gaming equipment like consoles, headsets, controllers, screens, keyboards, and more
  • PRE-MOISTENED WIPES: each wipe instantly removes dust, dirt, and stubborn smudges and fingerprints leaving a streak-free shine
  • ANTI-STATIC: great for cleaning and wiping down your gaming gear and electronics leaving behind no visible residue
  • COMPACT RESEALABLE PACKAGE: store your pack of Windex Gaming Wipes anywhere in your home for whenever a quick and easy wipedown is needed

Convert the PPK on Linux for OpenSSH

1. Install the PuTTY tools

On Debian- and Ubuntu-based systems, install the package named putty-tools:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
sudo apt install putty-tools

Other distributions use different package managers and package names. Install the distribution’s package that provides puttygen; the exact installation command is distribution-specific.

2. Convert the private key

Run puttygen with the PPK as input and request an OpenSSH private-key output:

puttygen keyfile.ppk -O private-openssh -o ~/.ssh/keyfile

The -O private-openssh option selects the OpenSSH private-key format. The -o option writes the converted key to the path you specify. Choose a filename that identifies the key without exposing its contents.

If the PPK has a passphrase, puttygen may ask for it during conversion. A successful conversion produces the output file; it does not change or delete the original PPK.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #3
Sale
LISEN Cell Phone Stand Phone Holder for Desk, Office Decor Gadgets for Men
  • Ergonomic & Adjustable Design: Fight "text neck" and improve your posture. Designed for comfort, it offers an adjustable height (7.1in-8.5in) (1.4in adjustable range) and angle (5°-85°) Please note: cell phone stand is only 9 inches tall—the length of a standard pencil
  • Without blocking subtitles Perfect for office desk Tiktok Face Time Zoom video—this is the ultimate kitchen desk essential for phones! Perfect viewing experience while reducing neck back strain, A must-have for gamers streamers desk, and anyone who values both style and support!
  • Sleek & Stable Design fits Otterbox Case: Say goodbye to bent cables, tangles, and tip-overs! LISEN’s stylish adjustable desk phone holder features a built-in charging hole and smart cable management, keeping your phone secure and your workspace clutter-free cool gadgets for men
  • ANTI-SLIP DESIGN free hands: The under 10.00 items easy gadgets back and the bottom of this kitchen essentials for women are fully covered by anti-skid silicone, which LISEN stand up desk decor can provide maximum protection device from any scratches and slides
  • Your Perfect Viewing Companion:If your product arrives damaged or breaks within 365 days, reach out to LISEN for a quick and hassle-free solution. Struggling with assembly, like tightening the screw? We’ve got your back! Your experience matters to us. (Product including: phone Holder stand*1, screw*1, hexagon screwdriver*1, specification*1)

3. Protect the converted file

chmod 600 ~/.ssh/keyfile

Use the actual path and filename you selected. If the file is readable by other users, the SSH client may reject it or the private key may be exposed to those users. Keep the file in a protected location under your home directory and do not upload it to the server.

4. Connect with the converted key

ssh -i ~/.ssh/keyfile [email protected]

Replace username with the account where you installed the public key and replace the hostname with the server’s real address. The client uses the private key named by -i and offers the matching public-key identity to the server.

5. Specify a non-default SSH port when necessary

ssh -i ~/.ssh/keyfile -p PORT [email protected]

Replace PORT with the server’s configured SSH port. A correct key cannot authenticate if the command reaches the wrong service or endpoint.

6. Turn on client diagnostics when a connection fails

ssh -v -i ~/.ssh/keyfile [email protected]

The -v option provides client-side diagnostic messages. Use it to confirm which hostname, port, and identity file the client is attempting. Do not publish diagnostic output if it contains private host details or other sensitive information.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

How the server decides whether to accept the key

When you run ssh -i, the client proves possession of the private key. The server checks whether the corresponding public key appears in the authorized_keys file for the account named in the connection command. The private key itself never belongs in that server file.

Rank #4
Ledagic IC+RGBW USB Powered Led Light Bar with App & Remote Control, 2 Pack
  • Easy Installation: Our gaming lights have been designed to enhance your entertainment experience. Simply position the led light bar next to your TV or game console to create a game room environment with ease. They come with USB power and a 60 inch cord for direct mounting and mobility
  • Audio Syncing & Extensive Mode: The built-in high-sensitivity music sensor allows you to sync the TV led lights to your favorite music. Lights react and move to the beat of music, film and game audio, creating an incredible immersive sound and light experience – and all without the need for an additional hub. You can choose from 64+ patterns, including strobe, illusion, jump, energy, gradient, running, chasing, fluttering mode etc. Each mode can be applied to different scenes
  • 64+ Chasing IC+RGB & W Effect: The independent control design of IC+RGB and white all-in-one multifunctional rgbw led bar lights monitor backlight allows you to easily switch the led lights for desk between IC+RGB and white to enjoy a variety of lighting effects, you can choose white lighting mode with high brightness for better illumination when working, etc. Choose IC+RGB lighting mode when you need to create an entertaining atmosphere for the light show, 16 million colours of Color changing rgb light bar let you dance to the beat and create a dynamic party atmosphere
  • Dynamic and Dimmable Lights: 1%-full brightness free brightness adjustment gives you the flexibility to adjust dimmable led light bar for room decorations or a variety of occasions
  • USB Powered: USB light bars for room can be powered by powernank, usb charger, TV, Monitor, laptop PC mainframe, making behind TV led lighting bar easy to install in any location.TV led lights are powered by the TV usb interface / PC mainframe, can be turned on/off synchronously with TV / PC

Three values must line up:

  • Key pair: the converted private key must correspond to the public key you installed.
  • Account: the username in the SSH command must be the account whose home directory contains the authorized key.
  • Endpoint: the hostname or IP address and SSH port must identify the intended server.

Ownership and permissions are part of the server-side check. A home directory or .ssh path that is writable by unrelated users can cause the server to reject an otherwise correct key. Verify the complete path, not only the final file.

Using the PPK directly with PuTTY on Windows

If you are connecting from Windows with PuTTY, conversion is unnecessary because PuTTY understands its native format. In PuTTY’s SSH authentication credentials panel, select the PPK private-key file. PuTTY’s documentation states: “This key must be in PuTTY’s native format (*.PPK).”

The Windows workflow is therefore different from the Linux OpenSSH workflow:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
  1. Open PuTTY and enter the server hostname, username, and SSH port in the session settings.
  2. Open the SSH authentication credentials panel.
  3. Select the original .ppk file as the private key.
  4. Open the session and enter the PPK passphrase when prompted, if one is set.

PuTTY can also work with Pageant, its authentication agent. Load the PPK into Pageant once, then let the agent supply the key to subsequent PuTTY connections instead of selecting the file for every session. Agent forwarding can make the agent available to a subsequent SSH hop; enable forwarding only when that multi-hop workflow requires it.

OpenSSH versus PuTTY: which workflow fits?

Aspect OpenSSH on Linux PuTTY on Windows
Client The system ssh command PuTTY
PPK conversion Usually required; convert with puttygen to an OpenSSH private key Not required; PuTTY reads PPK directly
Where the key is used A protected private-key file passed with -i A selected PPK file or a key loaded into Pageant
Passphrase handling The SSH client prompts unless an agent such as ssh-agent is holding the key PuTTY prompts unless Pageant is supplying the loaded key
Agent forwarding Available through an SSH-agent workflow when configured PuTTY can forward the Pageant agent for a subsequent SSH hop; enable it only when needed
Server requirement The matching public key must be in the target account’s authorized_keys, with appropriate ownership and permissions

Choose the client that matches where you are working. A PPK is not inherently tied to Windows; the key can be converted for Linux, while PuTTY can continue using the original file on Windows.

Best Value
Sale
HUANUO FlowLift™ Dual Monitor Stand, Fully Adjustable Gaming Monitor Desk Mount for 13–32″ Computer Screens, Full Motion VESA 75x75/100x100 with C-Clamp & Grommet Base, Each Arm Holds 4.4 to 19.8 lbs
  • Compatible with Wide Screens - To ensure compatibility with the dual monitor mount, your each monitor must meet three conditions at the same time: First, computer screens size range: 13 to 32 inches. Second, screen weight range: 4.4 to 19.8 lbs. Third, the back of the monitor screen must have VESA mounting holes with a pitch of 75x75mm or 100x100mm.
  • Regarding the compatibility with desks - Your desk must meet three conditions at the same time: First, desk material: Only wooden desks are recommended, plastic or glass desks cannot be used. Second, desk thickness range: 0.59" - 3.54". Third, the bottom of the desk should not have any cross beams or panels, as this will interfere with installation. We recommend carefully checking that your desk and monitors meets all above conditions before purchasing.
  • Dual C-Clamp Hold - Worried your dual monitors might wobble or slip? Our upgraded base uses a larger platform plus a dual C-clamp structure to lock the dual monitor arm firmly to your desk. Each arm safely keeps your screens steady while you type, click and game—no shaking, no sliding, just a clean and secure setup you can trust every day. It also provides Grommet Mounting installation choice, both options ensure stable and secure fixation for your 0.59" - 3.54" desk.
  • Full-Motion Adjustment For Comfortable View - Pull the screen closer when you’re deep in a spreadsheet, push it back to watch videos, or rotate to portrait for coding — moving everything smoothly with just one hand. The monitor stand offers +85°/-50° tilt, ±90° swivel and 360° rotation. Raise your monitor up to 15.75″ to support a healthy sitting posture. Whether you’re working from home, gaming through the night, or switching between video calls and documents, getting the screens to your natural line of sight helps relieve neck, shoulder and back strain so you can stay focused longer with less fatigue.
  • Keep Your Desk Organized: By lifting both screens off the desktop, this dual monitor stand opens up valuable space for your keyboard, notebook, docking station or a simple, clutter-free work area. Built-in cable management guides wires along the arms, keeping cords out of sight and out of the way. Enjoy a tidy, modern workstation that looks as good as it feels to use.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Troubleshooting common failures

“Invalid format” or “cannot load key”

The OpenSSH client is probably being given the PPK directly. Convert it with:

puttygen keyfile.ppk -O private-openssh -o ~/.ssh/keyfile

Then set mode 600 and point ssh -i at the converted file. Alternatively, use PuTTY or Pageant, which natively understand PPK.

What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

“Permission denied (publickey)”

  • Confirm that the public-key line is complete and unmodified.
  • Confirm that it is in the authorized_keys file for the account named in the command.
  • Check ownership of the account’s home directory, .ssh directory, and authorized_keys.
  • Check that those paths are not writable by unrelated users.
  • Verify that the private key you converted is the pair corresponding to the installed public key.

Use ssh -v to see the client-side identity and endpoint details while you investigate.

The key works for one username but not another

Authorization is account-specific. Install the matching public-key line in the second account’s authorized_keys file, or connect using the username for which it is already installed.

The command reaches the wrong server

Check the hostname or IP address and the SSH port. A valid key is rejected when the command connects to a different machine or service from the one where you installed the public key.

A passphrase prompt appears

A passphrase-protected key is expected to prompt when the client needs to unlock it. You can enter the passphrase, or load the key into an agent such as ssh-agent on Linux or Pageant with PuTTY so the agent performs the key handling for later connections.

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

The public key was copied from the wrong PuTTYgen field

Run puttygen keyfile.ppk -L and use the OpenSSH public-key output. A fingerprint or a proprietary display is not the complete line that belongs in authorized_keys.

The server file looks correct but authentication still fails

Trace the entire path from the account’s home directory to authorized_keys. Verify the account owner, restrictive permissions, exact username, exact endpoint, and that no line wrapping or truncation occurred when the key was pasted. These checks distinguish a server authorization problem from a client format problem.

Security practices for PPK conversion and SSH login

  • Protect private material: keep the PPK and converted private key out of public repositories, chat messages, issue trackers, and server configuration files.
  • Use restrictive client permissions: apply chmod 600 to the converted private key and store it under a protected ~/.ssh path.
  • Install only the public half on the server: the server needs the OpenSSH public-key line, never the private key.
  • Limit agent forwarding: forwarding exposes an agent to a subsequent SSH hop, so enable it only for a workflow that requires it.
  • Keep the account and endpoint explicit: record which username and server each authorized key is intended to access so a correct key is not tested against the wrong target.
  • Retain a recovery path: do not remove an existing access method until the converted key has successfully authenticated and you have verified the account and server.

Command reference

Purpose Command
Install PuTTY tools on Debian- or Ubuntu-based Linux sudo apt install putty-tools
Extract the OpenSSH public-key line puttygen keyfile.ppk -L
Convert PPK to an OpenSSH private key puttygen keyfile.ppk -O private-openssh -o ~/.ssh/keyfile
Protect the converted private key chmod 600 ~/.ssh/keyfile
Connect on the standard SSH port ssh -i ~/.ssh/keyfile [email protected]
Connect on a specified port ssh -i ~/.ssh/keyfile -p PORT [email protected]
Enable client diagnostics ssh -v -i ~/.ssh/keyfile [email protected]
Harden server path write permissions chmod go-w $HOME $HOME/.ssh $HOME/.ssh/authorized_keys

End-to-end checklist

  1. Identify the target username, hostname or IP address, and SSH port.
  2. Confirm that the server has the PPK’s matching public key in that account’s authorized_keys.
  3. Install the package that provides puttygen on the Linux client.
  4. Extract the public-key line with puttygen keyfile.ppk -L if server preparation is still needed.
  5. Convert the PPK with the private-openssh output option.
  6. Set the converted key to mode 600.
  7. Run ssh -i with the same username and endpoint used during server preparation.
  8. If authentication fails, use ssh -v, then check format, key pairing, account, endpoint, and permissions in that order.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More quests from Patch Notes

  1. How to Set Up a RedM (RDR2) Server in 2026: License Key, txAdmin and server.cfg, Step by StepBlog11min
  2. Best RedM (RDR2) Server Hosting in 2026: Comparing Four Hosts on Slots, Memory and PriceBlog10min
  3. How to Host a Mindustry Server in 2026: server-release.jar, Port 6567 and the Commands That MatterBlog7min
Recommended PC Tool
Recommended PC Tool
Windows Errors? Fix Them Before They SpreadFree repair scan
Crashes, No Sound, or Screen Glitches?Free driver scan

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.