SECURE

SHELL   PRODUCTS SUPPORT COMPANY INVESTORS TRY PRIVX

SSH COMMUNITY
SOLUTIONS CUSTOMER SUPPORT
Your browser does not allow storing cookies. We recommend enabling them.
Want to try the fastest enterprise-grade ×
ABOUT US

SSH.COM uses cookies to give you the best experience and most relevant marketing. More info
INVESTORS TRY PRIVX

SFTP? SSH (Secure Shell) home

PrivX Product documentation
Company overview
Investors Try PrivX in your browser

Download free SSH clients

PrivX Free DECLINE GOT IT!
How to report vulnerabilities
Contact us Get PrivX free

Get a free 45 day trial

SSH key management
Universal SSH Key Manager Find a local partner

Ephemeral access & certificates

CryptoAuditor Careers

Identity and access management

Tectia Executive management

YOUR NEEDS
The next generation of privileged access management Board of directors
Home » SSH » PuTTY » putty-manuals » PuTTY User Manual (putty-0.68-manual)
Cert & Key Management Legal information

Compliance & Audit SSH.COM blog

Previous | Contents | Index | Next

Secure cloud file transfer Auf Deutsch

PUTTY USER MANUAL Privileged Access Management En español

PuTTY is a free (MIT-licensed) Windows Telnet and SSH client. This manual documents PuTTY, and its
The best free VPN replacement In het Nederlands

companion utilities PSCP, PSFTP, Plink, Pageant and PuTTYgen.

En français

Note to Unix users: this manual currently primarily documents the Windows versions of the PuTTY utilities.
Some options are therefore mentioned that are absent from the Unix version; the Unix version has features
not described here; and the pterm and command-line puttygen utilities are not described at all. The
only Unix-specific documentation that currently exists is the man pages.

This manual is copyright 1997-2017 Simon Tatham. All rights reserved. You may distribute this
documentation under the MIT licence. See appendix C for the licence text in full.

Chapter 1: Introduction to PuTTY

1.1 What are SSH, Telnet and Rlogin?
1.2 How do SSH, Telnet and Rlogin differ?
Chapter 2: Getting started with PuTTY
2.1 Starting a session
2.2 Verifying the host key (SSH only)
2.3 Logging in
2.4 After logging in
2.5 Logging out
Chapter 3: Using PuTTY
3.1 During your session
3.2 Creating a log file of your session
3.3 Altering your character set configuration
3.4 Using X11 forwarding in SSH
3 5 Using port forwarding in SSH
 3.5 Using port forwarding in SSH
3.6 Making raw TCP connections
3.7 Connecting to a local serial line
3.8 The PuTTY command line
Chapter 4: Configuring PuTTY
Want to try the fastest enterprise-grade
4.1 The Session panel
×
SFTP? 4.2 The Logging panel
4.3 The Terminal panel
Get a free 45 day trial
4.4 The Keyboard panel
4.5 The Bell panel
4.6 The Features panel
4.7 The Window panel
4.8 The Appearance panel
4.9 The Behaviour panel
4.10 The Translation panel
4.11 The Selection panel
4.12 The Colours panel
4.13 The Connection panel
4.14 The Data panel
4.15 The Proxy panel
4.16 The Telnet panel
4.17 The Rlogin panel
4.18 The SSH panel
4.19 The Kex panel
4.20 The Host Keys panel
4.21 The Cipher panel
4.22 The Auth panel
4.23 The GSSAPI panel
4.24 The TTY panel
4.25 The X11 panel
4.26 The Tunnels panel
4.27 The Bugs and More Bugs panels
4.28 The Serial panel
4.29 Storing configuration in a file
Chapter 5: Using PSCP to transfer files securely
5.1 Starting PSCP
5.2 PSCP Usage
Chapter 6: Using PSFTP to transfer files securely
6.1 Starting PSFTP
6.2 Running PSFTP
6.3 Using public key authentication with PSFTP
Chapter 7: Using the command-line connection tool Plink
7.1 Starting Plink
7.2 Using Plink
7.3 Using Plink in batch files and scripts
7.4 Using Plink with CVS
7.5 Using Plink with WinCVS
Chapter 8: Using public keys for SSH authentication
8.1 Public key authentication - an introduction
8.2 Using PuTTYgen, the PuTTY key generator
8.3 Getting ready for public key authentication
Chapter 9: Using Pageant for authentication
9.1 Getting started with Pageant
9.2 The Pageant main window
9.3 The Pageant command line
9.4 Using agent forwarding
9.5 Security considerations
Chapter 10: Common error messages
10.1 ‘The server's host key is not cached in the registry’
10.2 ‘WARNING - POTENTIAL SECURITY BREACH!’
10.3 ‘SSH protocol version 2 required by our configuration but server only provides (old,
insecure) SSH-1’
10.4 ‘The first cipher supported by the server is ... below the configured warning threshold’
10.5 ‘Server sent disconnect message type 2 (protocol error): "Too many authentication
failures for root"’
10.6 ‘Out of memory’
10.7 ‘Internal error’, ‘Internal fault’, ‘Assertion failed’
10.8 ‘Unable to use this private key file’, ‘Couldn't load private key’, ‘Key is of wrong type’
10.9 ‘Server refused our public key’ or ‘Key refused’
10.10 ‘Access denied’, ‘Authentication refused’
10.11 ‘No supported authentication methods available’
10.12 ‘Incorrect CRC received on packet’ or ‘Incorrect MAC received on packet’
10.13 ‘Incoming packet was garbled on decryption’
10.14 ‘PuTTY X11 proxy: various errors’
10.15 ‘Network error: Software caused connection abort’
10.16 ‘Network error: Connection reset by peer’
10.17 ‘Network error: Connection refused’
10.18 ‘Network error: Connection timed out’
10.19 ‘Network error: Cannot assign requested address’
Appendix A: PuTTY FAQ
A.1 Introduction
A 2 Features supported in PuTTY
 A.2 Features supported in PuTTY
A.3 Ports to other operating systems
A.4 Embedding PuTTY in other programs
A.5 Details of PuTTY's operation
A.6 HOWTO questions
A.7 Troubleshooting
A.8 Security questions
A.9 Administrative questions
A.10 Miscellaneous questions
Appendix B: Feedback and bug reporting
B.1 General guidelines
B.2 Reporting bugs
B.3 Reporting security vulnerabilities
B.4 Requesting extra features
B.5 Requesting features that have already been requested
B.6 Support requests
B.7 Web server administration
B.8 Asking permission for things
B.9 Mirroring the PuTTY web site
B.10 Praise and compliments
B.11 E-mail address
Appendix C: PuTTY Licence
Appendix D: PuTTY hacking guide
D.1 Cross-OS portability
D.2 Multiple backends treated equally
D.3 Multiple sessions per process on some platforms
D.4 C, not C++
D.5 Security-conscious coding
D.6 Independence of specific compiler
D.7 Small code size
D.8 Single-threaded code
D.9 Keystrokes sent to the server wherever possible
D.10 640×480 friendliness in configuration panels
D.11 Automatically generated Makefiles
D.12 Coroutines in ssh.c
D.13 Single compilation of each source file
D.14 Do as we say, not as we do
Appendix E: PuTTY download keys and signatures
E.1 Public keys
E.2 Security details
E.3 Key rollover
 Appendix F: SSH-2 names specified for PuTTY
F.1 Connection protocol channel request names
F.2 Key exchange method names
F.3 Encryption algorithm names
Index

If you want to provide feedback on this manual or on the PuTTY tools themselves, see the Feedback page.

[PuTTY release 0.68]

What to read next:

 REDUCE SECURE SHELL RISK. GET TO KNOW THE NIST 7966.

The NISTIR 7966 guideline from the Computer Security Division of NIST is a direct call to action
for organizations regardless of industry and is a mandate for the US Federal government.
Download now

ISACA PRACTITIONER GUIDE FOR SSH

With contributions from practitioners, specialists and SSH.COM experts, the ISACA “SSH:
Practitioner Considerations” guide is vital best practice from the compliance and audit
community.
Download now

NEAREST SSH.COM OFFICE QUICK LINKS

SSH Communications Security, Inc. Get a demo

460 Totten Pond Road #460 Blog
Waltham, MA 02140 PrivX
USA Universal SSH Key Manager software
781-247-2100 CryptoAuditor
Contact us Tectia
Support
About us
Contact
Home
Auf Deutsch
En español
In het Nederlands
En français

Copyright ©2018 SSH Communications Security, Inc. All Rights Reserved. See Data Privacy Policy, Website
Terms of Use, and Standard Terms and Conditions EULAs

