Installation
Pip Binary Packages
pip install ssh-python
will attempt to download a pre-compiled wheel, or try to build from source if one does not exist for the platform.
pip install -U pip
to upgrade version of pip, helpful on older Python installations.
Building from Source
By default, the package will try to build against an embedded version of libssh
.
To build against a system library, export the SYSTEM_LIBSSH=1
environment variable prior to building.
The following libraries are required:
OpenSSL 1.0 or 1.1, >=1.1 for Ed25519 support
Kerberos 5 for GSSAPI authentication
Zlib for compression support
Pip Installation Methods
pip install .
in the sources root directory will build and install a wheel.
pip wheel .
to build a wheel alone.
System Installation Methods
python setup.py install
when wanting to make a system package, or to install in site-packages
.
SYSTEM_LIBSSH=1 python setup.py install
to build against system libssh and install to site-packages
.
Building on Windows
Requirements:
Python >= 3.6
Visual Studio 14 or above
OpenSSL 1.1
Zlib
Kerberos 5 for GSSAPI authentication
libssh
Steps
Build and install dependencies
Install python package via
python setup.py install
orpip install .
*pip wheel .
as before for creating a wheel.
Note dependencies will need to be built statically to be distributable to other Windows systems.
Cygwin/MingW probably do not work.