summaryrefslogtreecommitdiff
path: root/doc/en/install.txt
blob: 177c250976abe0673a2f694d0f5a9b3e1ea86f55 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
Install
=======

NOTE: 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)
* *Frugalware*: Just use pacmang-g2 to install the poezio package. (Thanks to
 its maintainer, Kooda)
* *Debian*: Use an other distro.

(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 https://dev.louiz.org/project/poezio/download[stable
 sources] or fetch the development version (trunk), using git:
============================
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
 https://github.com/fritzy/SleekXMPP/[SleekXMPP] page and the
 http://www.dnspython.org/[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, follow these
 instructions. Else, go to the next section (recommended).


Download SleekXMPP
============================
git clone https://github.com/fritzy/SleekXMPP.git
============================

Make sure you're using the develop branch by typing
============================
cd SleekXMPP

git checkout develop
============================

Install SleekXMPP with
============================
python3 setup.py build

su -c "python3 setup.py install"
============================

Install the dnspython3 package on your distribution or install it manually:
============================
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:
============================
python3 setup.py build

su -c "python3 setup.py install"
============================


=== 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:
============================
sh update.sh
============================

If you have git installed, it will download and update locally the
 libraries for you.


If you don't want to install poezio but just test it (or keep a development
 version), do:
============================
 ./launch.sh
============================


To install poezio, do, as root (or sudo with ubuntu or whatever):
============================
make install
============================

And then start it with:
============================
poezio
============================