130 lines
3.5 KiB
ReStructuredText
130 lines
3.5 KiB
ReStructuredText
|
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 <poezio-install-label>` (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/
|