install.rst 4.88 KB
Newer Older
mathieui's avatar
mathieui committed
1
Installing poezio
2 3 4 5 6
=================

.. 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).

mathieui's avatar
mathieui committed
7
poezio in the GNU/Linux distributions
8 9 10 11 12 13
-------------------------------------

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.

mathieui's avatar
mathieui committed
14
- *Archlinux*: A poezio_ and poezio-git_ packages are in AUR (use your favourite
15 16 17
    AUR wrapper to install them)
- *Gentoo*: `Sekh’s overlay`_ contains everything required to build poezio
    (sleekxmpp, dnspython, and poezio)
18 19
- *Fedora*: The poezio package was out of date for a long time in Fedora, but
    now thanks to Casper, there is an `up-to-date package`_ in the repos since F19.
20 21
- *Debian*: Use an other distro. (or make a package, we can provide help :) )

22
(If another distribution provides a poezio package, please tell us and we will
mathieui's avatar
mathieui committed
23
add it to the list)
24 25 26 27

Install poezio from the sources
-------------------------------

28 29 30
.. note:: The ``make`` command is always required, because while we could provide
    the compiled file into the archive, the ABI changes and platform variety would
    make it sure that the list of archives is either incomplete or wrong.
31

32 33
    Packagers are of course welcome to compile the file and include it in their
    architecture-specific and fixed-python packages.
34 35


36 37
Stable version
~~~~~~~~~~~~~~
38

39 40 41 42 43
`Stable version`_ packages are available. the ``python3-devel`` package or similar
is required.

If you take the standalone package with all the deps, you only need to run ``make``
to have a working poezio install.
44

45
If you don’t, please scroll down to the dependencies.
46 47


48 49
Development version
~~~~~~~~~~~~~~~~~~~
50

51 52 53 54
The stable versions of poezio are more like snapshots of states of
development we deem acceptable. There is always an incentive to
use the development version, like new features, bug fixes, and more
support. Therefore, you might want to use the git version.
55 56 57

.. code-block:: bash

58 59 60
    git clone git://git.poez.io/poezio
    cd poezio
    make
61

62 63
Dependencies
~~~~~~~~~~~~
64

65 66 67
"""""""
General
"""""""
68

69 70
Poezio is a python3-only application, so you will first need that, preferably
in the latest available version, down to 3.2.
71

72 73 74 75 76
.. note:: Python 3.1 is not officially supported and tested, but should
    work (if it doesn’t, we can fix it if the fix does not require ugly
    modifications). In this case, you will want to install the
    python3-argparse package if it exists, or use pip3/virtualenvs to
    install it.
77

78 79
You will first need python3-devel, or whatever your distribution named it, along
with standard utilities such as make.
80

81
Poezio depends on two libraries:
82

83 84 85 86 87 88 89 90 91 92 93 94 95 96 97
- DNSPython_ (the python3 version, often called dnspython3)
- SleekXMPP_

If you do not want to install those libraries, you can skip directly to
the :ref:`installation part <poezio-install-label>`


"""""""""
DNSPython
"""""""""

It should be available right now in most software repositories, under the name
``python3-dnspython`` or ``python3-dnspython3``. Any stable version should fit.

For a manual install:
98 99 100

.. code-block:: bash

101 102 103 104 105 106 107 108 109
    wget -O dnspython.tar.gz http://www.dnspython.org/kits3/1.11.1/dnspython3-1.11.1.tar.gz
    tar xvf dnspython.tar.gz
    cd dnspython3-1.11.1
    python3 setup.py build
    python3 setup.py install --user

""""""
SleekXMPP
""""""
110

111 112
Poezio now depends on SleekXMPP 1.2. if your distribution does not provide it yet,
you can install it this way:
113 114 115

.. code-block:: bash

116 117 118
    wget https://github.com/fritzy/SleekXMPP/archive/1.2.0.tar.gz
    tar xvf 1.2.0.tar.gz
    SleekXMPP-1.2.0
119
    python3 setup.py build
120 121
    python3 setup.py install --user

122 123 124

.. _poezio-install-label:

125 126
Installation
~~~~~~~~~~~~
127

mathieui's avatar
mathieui committed
128 129 130
.. note::

    The update.sh + launch.sh method is the recommended way of using and upgrading
131
    the devel version of poezio. Installing should only be done with stable versions.
mathieui's avatar
mathieui committed
132

133 134 135

If you skipped the installation of the dependencies and you only want to run
poezio without a system-wide install, do, in the :file:`poezio` directory:
136 137 138 139 140 141

.. code-block:: bash

    ./update.sh

If you have git installed, it will download and update locally the
mathieui's avatar
mathieui committed
142
libraries for you. (and if you don’t have git installed, install it)
143 144


145
To run poezio directly from the directory, do:
146 147 148 149 150

.. code-block:: bash

    ./launch.sh

151 152

If you really want to install it, run as root (or sudo in ubuntu or whatever):
153 154 155 156 157 158 159 160 161 162 163 164 165 166

.. 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/
167
.. _DNSPython: http://www.dnspython.org/
mathieui's avatar
mathieui committed
168 169
.. _poezio: https://aur.archlinux.org/packages/poezio/
.. _poezio-git: https://aur.archlinux.org/packages/poezio-git/
170
.. _up-to-date package: https://apps.fedoraproject.org/packages/poezio