====== Installation of PyHoca-CLI ======

The name PyHoca is a word play combining two powerful entities: Python and Phoca (mascot of X2go, Latin species name for seals). 

PyHoca-CLI is a client implementation for X2Go using [[wiki:libs:python-x2go|the project's Python API]] (Python module). PyHoca-CLI can be operated completely from the command line and the goal is to reflect the full functionality spectrum of [[wiki:libs:python-x2go|Python X2Go]]. 

===== Debian GNU/Linux =====

PyHoca-CLI can be installed from the X2Go package repository. [[wiki:repositories:debian|Add the X2Go repository for Debian to your APT system]] before you continue.

===== Raspbian GNU/Linux =====

PyHoca-CLI can be installed from the X2Go package repository. [[wiki:repositories:raspbian|Add the X2Go repository for Raspbian to your APT system]] before you continue.

===== Ubuntu GNU/Linux =====

PyHoca-CLI can be installed from X2Go PPA on Launchpad. [[wiki:repositories:ubuntu|Add the X2Go/stable PPA to your APT system]] before you continue.

==== ====

After adding either of the above package sources to your Debian/Raspbian/Ubuntu system you will need to update your system with the new repository information by starting a terminal and execute the following commands (on Debian make sure you have sudo installed and configured):

<code>
$ sudo aptitude update
$ sudo aptitude install pyhoca-cli
</code>

===== Other GNU/Linux (from source tarball) =====

Other GNU/Linux distributions can install PyHoca-CLI from source tarballs. The PyHoca-CLI tarball releases can be downloaded from http://code.x2go.org/releases/source/pyhoca-cli, please choose the newest version available there and also consult the README.recommended file (if available) at the same location.

Before installation make sure your system fulfills the (Python module) dependencies for PyHoca-CLI, amongst others: python-x2go, python-paramiko, python-gevent, python-greenlet, python-setproctitle, python-argparse. 

If you have seen to installing required dependencies, extract the source tarball and run the Python installation script:

<code>
tar -vzxf pyhoca-cli_<version>.tar.gz
cd pyhoca-cli_<version>
python setup.py install
</code>

There also is a good from-source [[wiki:development:build-howto-linux:pyhoca-cli|PyHoca-CLI build+installation howto]] in the development area of this Wiki.

===== MS Windows =====

A PyHoca-CLI installer for MS Windows is planned, but not available, yet.

===== MacOS =====

A PyHoca-CLI installer for MacOS is planned, but not available, yet.