Installing Poezio ================= .. important:: Python 3.2 or better is highly recommended, as we do not officially support python 3.1 (although we do try to keep things running). Poezio in the GNU/Linux distributions ------------------------------------- As far as I know, Poezio is available in the following distributions, you just have to install it by using the package manager of the distribution, if you're using one of these. - *Archlinux*: A poezio and poezio-git packages are in AUR (use your favourite AUR wrapper to install them) - *Gentoo*: `Sekh’s overlay`_ contains everything required to build poezio (sleekxmpp, dnspython, and poezio) - *Debian*: Use an other distro. (or make a package, we can provide help :) ) (If an other distribution provides a poezio package, please tell us and we will add it to the list) Install poezio from the sources ------------------------------- You can download poezio's `stable sources`_, or fetch the development version (trunk), using git: .. code-block:: bash git clone https://git.louiz.org/poezio .. note:: To clone the repo, which uses a self-signed certificated, you can prefix the clone command with GIT_SSL_NO_VERIFY=1. In order for poezio to correctly work, you need the libs SleekXMPP and dnspython. You can install them by downloading it from the `SleekXMPP`_ page and the `dnspython`_ page , but you'll need the development version of SleekXMPP. Alternatively, you can download poezio's sources including SleekXMPP and dnspython, that's the easier way. """""""""""" Dependencies """""""""""" .. note:: If your python3 version is too old because of debian (e.g. < 3.2), you should install the python3-argparse package if it exists, or use pip3/virtualenvs to install it. If you want to install SleekXMPP and dnspython by yourself, use the following instructions. Else, go to the :ref:`next section ` (recommended). Download SleekXMPP .. code-block:: bash git clone git://github.com/fritzy/SleekXMPP.git Make sure you're using the develop branch by typing .. code-block:: bash cd SleekXMPP git checkout develop Install SleekXMPP with .. code-block:: bash python3 setup.py build su -c "python3 setup.py install" Install the dnspython3 package on your distribution or install it manually: .. code-block:: bash wget -O dnspython.tgz http://www.dnspython.org/kits3/1.10.0/dnspython3-1.10.0.tar.gz tar xvf dnspython.tgz cd dnspython3-1.10.0 And do the same again: .. code-block:: bash python3 setup.py build su -c "python3 setup.py install" .. _poezio-install-label: """"""""""""""""""" Poezio installation """"""""""""""""""" If you skipped the installation of the dependencies and you only want to test poezio without a system-wide install, do, in the *poezio* directory: .. code-block:: bash ./update.sh If you have git installed, it will download and update locally the libraries for you. (and if you don’t have git installed, install it) If you don't want to install poezio but just test it (or keep a development version), do: .. code-block:: bash ./launch.sh To install poezio, do, as root (or sudo with ubuntu or whatever): .. code-block:: bash make install And then start it with: .. code-block:: bash poezio .. _Sekh’s overlay: https://github.com/sekh/sekh_overlay .. _stable sources: https://dev.louiz.org/project/poezio/download .. _SleekXMPP: https://github.com/fritzy/SleekXMPP/ .. _dnspython: http://www.dnspython.org/