paramiko: ssh2 protocol for python

paramiko
SSH2 protocol for python

last updated 23-Mar-2008

paramiko is a module for python 2.2 (or higher) that implements the SSH2 protocol for secure (encrypted and authenticated) connections to remote machines. unlike SSL (aka TLS), SSH2 protocol does not require heirarchical certificates signed by a powerful central authority. you may know SSH2 as the protocol that replaced telnet and rsh for secure access to remote shells, but the protocol also includes the ability to open arbitrary channels to remote services across the encrypted tunnel -- this is how sftp works, for example.

it is written entirely in python (no C or platform-dependent code) and is released under the GNU LGPL (lesser GPL).

there is now also a java port.

news

Clara

23 Mar 2008	paramiko 1.7.3 "Clara" released many bug fixes
21 Jan 2008	paramiko 1.7.2 "Basil" released direct-tcpip support; bug fixes
10 Jun 2007	paramiko 1.7.1 "Amy" released bug fixes
18 Feb 2007	paramiko 1.7 "zubat" released x11 and reverse port forwarding support; bug fixes
19 Nov 2006	paramiko 1.6.4 "yanma" released bug fixes

download

milestone releases are being named alphabetically after children from edward gorey's "gashlycrumb tinies". previously they were named after pokémon.

paramiko-1.7.3.zip "Clara" (signature)
MD5 = e3afb281daf1b52281e872386c196e5d
paramiko-1.7.3.tar.gz "Clara" (signature)
MD5 = b8f3f65c0b8283b77f976eb9427dc17a
older releases

pre-built packages for some systems are maintained by external sites:

Red Hat/Fedora RPMs (from DAG)
Red Hat/Fedora RPMs (from Dries)
Debian (in unstable)
Ubuntu (in gutsy)

the Debian and Ubuntu packages are often months out of date. sorry, it's out of my control.

requirements

platforms supported: POSIX (Linux, Solaris, BSD, etc.); MacOS X; Windows
python 2.3: python 2.2 is also supported, but not recommended.
pycrypto 1.9+: pycrypto 2.0 has been tested too.

documentation

there is extensive online API documentation.
check out the demo scripts in the distribution.
there's also a low-volume mailing list.

development

i happily accept patches, either via email to the mailing list, or by merging if you have a branch.

project/bugs: http://launchpad.net/products/paramiko
source repository: http://www.lag.net/paramiko/bzr/paramiko/
the source code is kept in a bazaar (bzr) archive. fetching the source is as simple as:
```
    $ bzr branch http://www.lag.net/paramiko/bzr/paramiko/
```
browse the source using loggerhead
my public GPG key

free banner!