How to Export and Import PuTTY Sessions and Settings (Backup Guide)

Export PuTTY sessions from HKCU\Software\SimonTatham\PuTTY\Sessions and import the .reg file under the destination Windows user. Export the parent PuTTY key for the broader configuration, including cached SSH host keys. These commands apply to standard PuTTY on Windows; portable wrappers and Unix builds can use different storage.

How do I export and import PuTTY settings?

In Command Prompt, run the export on the old machine:

reg export "HKCU\Software\SimonTatham\PuTTY" "%USERPROFILE%\putty-backup.reg"

Copy that file privately to the destination user's profile folder. Back up that user's existing PuTTY settings before merging, inspect the file, then run:

reg import "%USERPROFILE%\putty-backup.reg"

In PowerShell, use its environment-variable syntax instead:

reg export "HKCU\Software\SimonTatham\PuTTY" "$env:USERPROFILE\putty-backup.reg"

reg import "$env:USERPROFILE\putty-backup.reg"

Run each command in its indicated shell. %USERPROFILE% is CMD syntax; PowerShell uses $env:USERPROFILE. An export/import into your own writable HKCU key normally does not require an administrator account. Check the command's success message before moving on.

Jump to:

• Where PuTTY stores its data
• Export everything with regedit
• Import on the target machine
• Export only the saved sessions
• Export with PowerShell
• Verify the export worked
• Transferring between user accounts
• Troubleshooting: Access Denied and other errors
• Modern alternatives to PuTTY
• FAQ

Where PuTTY stores its data

The standard Windows registry layout:

This is the standard Windows PuTTY configuration location. Private .ppk keys and log files are separate files; their paths in a saved session do not copy their contents. Transfer needed private keys separately and protect them as credentials.

Open regedit.exe, navigate to HKEY_CURRENT_USER\Software\SimonTatham\PuTTY, and you can see the whole thing in the tree. The Sessions subkey is where the "Saved Sessions" list in PuTTY's launch dialog comes from.

Export everything with regedit

Press Win+R, type cmd, press Enter. Then:

regedit /E "%USERPROFILE%\Documents\putty-full.reg" "HKEY_CURRENT_USER\Software\SimonTatham\PuTTY"

regedit /E exports a registry key to a .reg file. The flags:

• /E, export mode
• First argument, output file path (quoted to handle spaces in usernames)
• Second argument, the registry key to export

After it runs (silently, no progress dialog), Documents\putty-full.reg will contain every PuTTY session, host-key cache, and preference. Open it in Notepad to verify; you should see a [HKEY_CURRENT_USER\Software\SimonTatham\PuTTY] block at the top and a long list of [HKEY_CURRENT_USER\Software\SimonTatham\PuTTY\Sessions\<session-name>] blocks below it.

The file is readable text and can expose hostnames, usernames, proxy settings, and trusted host keys. Keep the backup private and inspect it before import; a .reg file can modify registry values beyond PuTTY if someone has changed its contents.

Import on the target machine

On the destination Windows machine, copy the .reg file over (USB stick, OneDrive, scp, however you move files). Then either:

Option A, interactive merge:

Double-click the .reg file. Windows shows a "Registry Editor, Are you sure you want to continue?" dialog. Click Yes. The settings merge into HKEY_CURRENT_USER\Software\SimonTatham\PuTTY.

Option B, silent merge from Command Prompt:

regedit /S "%USERPROFILE%\Documents\putty-full.reg"

/S (silent) skips the confirmation dialog. Useful for scripting.

After the merge, open PuTTY, the saved sessions list should now show every session from the source machine.

Important caveat about merge semantics: regedit /S MERGES the keys; it doesn't replace them. If the target machine has session "production" and the import also has "production", the imported version wins. If the target has session "staging" that's not in the import, "staging" is left alone. Back up the destination settings first. Do not delete the whole PuTTY key merely to add sessions.

Export only the saved sessions

If you want to back up just your session list (no host keys, no global preferences), target the \Sessions subkey:

regedit /E "%USERPROFILE%\Documents\putty-sessions.reg" "HKEY_CURRENT_USER\Software\SimonTatham\PuTTY\Sessions"

This is what you want when migrating between machines but each machine has its own host-key cache (and you don't want to override them) or its own global preferences.

To export a single session by name, drill down further:

regedit /E "%USERPROFILE%\Documents\production-session.reg" "HKEY_CURRENT_USER\Software\SimonTatham\PuTTY\Sessions\production"

PuTTY encodes spaces in session names as %20 in the registry path, so a session named "Production Server" lives at \Sessions\Production%20Server.

Export with PowerShell

Call the Windows reg.exe program from PowerShell:

$dest = "$env:USERPROFILE\Documents\putty-full.reg"
reg export "HKCU\Software\SimonTatham\PuTTY" $dest /y

The /y flag overwrites the file without prompting. HKCU is shorthand for HKEY_CURRENT_USER.

For a sessions-only PowerShell export:

reg export "HKCU\Software\SimonTatham\PuTTY\Sessions" "$env:USERPROFILE\Documents\putty-sessions.reg" /y

The PowerShell-native cmdlets (Get-ItemProperty, Export-Clixml) work too but produce a non-.reg format that won't import via double-click. Stick with reg export for portability.

Verify the export worked

A .reg file should:

• Contain the sessions you selected; file size alone does not prove that the backup is complete.
• Start with Windows Registry Editor Version 5.00 on the first line.
• Contain at least one [HKEY_CURRENT_USER\Software\SimonTatham\PuTTY\Sessions\<name>] block.

Quick check from cmd:

type "%USERPROFILE%\Documents\putty-full.reg" | findstr /R "^\["

That prints every section header in the file, one line per session and one for each subkey. Count the lines to confirm everything is captured.

From PowerShell:

Select-String -Path "$env:USERPROFILE\Documents\putty-full.reg" -Pattern '^\['

Transferring between user accounts

PuTTY's data is per-user (in HKEY_CURRENT_USER), so two accounts on the same machine have completely separate PuTTY configurations. To copy from User A to User B on the same Windows install:

1. Sign in as User A.
2. Export to a path readable by User B, somewhere outside User A's profile, like C:\Temp\putty.reg.
3. Sign in as User B.
4. Open the file, merge it.

If you forget step 2 and export into User A's Documents, User B won't have read access by default. Either re-export to a shared location or copy the file to C:\Temp first as an administrator.

Same principle for transferring between machines: the .reg file is portable; the destination user account writes its own copy into its own HKEY_CURRENT_USER.

Troubleshooting: Access Denied and other errors

"Access is denied" when running regedit /E. Two common causes:

• The target file location requires admin rights (e.g., writing to C:\Program Files). Choose a path under %USERPROFILE% instead.
• The registry key path is wrong, with backslashes missing or doubled. Verify by opening regedit.exe and navigating to the path manually, if it doesn't exist, your command will fail silently.

"The specified file does not contain a valid registry script" when merging. The .reg file got corrupted in transit, usually because it was opened and saved by an editor that converted UTF-16 to UTF-8 or stripped the BOM. Re-export and copy with binary-mode tools (Robocopy, SCP with -r, USB).

Imported but PuTTY shows no new sessions. Import under the account that runs PuTTY. Elevation with the same account does not automatically select a different profile, but supplying another account's credentials can. Verify the current user and HKCU path.

Selective import shows registry path errors. PuTTY session names with spaces or special characters are URL-encoded in the registry path (%20 for space, %2E for .). When editing a .reg file to subset its sessions, preserve the encoding exactly.

Host-key warnings reappear after import. A sessions-only backup does not include trusted host keys. Check that the hostname, port, and key type match the connection you backed up. Independently verify a changed server fingerprint; deleting the trust cache or accepting a new key blindly is not a migration fix.

Modern alternatives to PuTTY

In 2026, Windows has built-in alternatives that don't store configuration in the registry and migrate more cleanly:

• OpenSSH client (built into Windows 10 1809+ and all of Windows 11). Configuration in %USERPROFILE%\.ssh\config, a plain text file that copies between machines and version-controls trivially.
• Windows Terminal with OpenSSH profiles, settings in settings.json under %LOCALAPPDATA%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState\.
• MobaXterm, a richer PuTTY replacement with a built-in file manager, X11 forwarding, and the ability to export sessions to a single portable file.
• WSL2 + OpenSSH, Linux-native ssh tooling with full bash, ~/.ssh/config, and standard Unix workflows.

If you're starting fresh on a new Windows machine and not bound by existing PuTTY sessions, OpenSSH + ~/.ssh/config is the cleaner long-term setup. For migrating existing PuTTY users, the registry export above remains the fastest path.

What to do next

For broader DevOps reference:

• Tor Country Codes for ExitNodes, ExcludeNodes, and torify, also config-file driven, also lots of registry/file gotchas.

For backup workflows in adjacent stacks:

• How to Export All MySQL Databases with mysqldump, the database equivalent of "back up everything to one portable file".

FAQ