133 lines
3.6 KiB
ReStructuredText
133 lines
3.6 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 git://git.poez.io/poezio
|
||
|
||
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
|
||
"""""""""""""""""""
|
||
|
||
.. note::
|
||
|
||
The update.sh + launch.sh method is the recommended way of using and upgrading
|
||
poezio.
|
||
|
||
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/
|
||
.. _poezio: https://aur.archlinux.org/packages/poezio/
|
||
.. _poezio-git: https://aur.archlinux.org/packages/poezio-git/
|