Mercurial > libervia-backend
annotate doc/installation.rst @ 3743:54c249ec35ce
core (memory/migration): ignore FTS table when autogenerating script for migration:
SQLite Full-Text Search stable are not associated to Python object and can't be detected
by Alembic. To avoid the generation of unwanted drop commands, they are now ignored when
autogenerating migration scripts.
rel 364
| author | Goffi <goffi@goffi.org> |
|---|---|
| date | Tue, 22 Mar 2022 17:00:42 +0100 |
| parents | 267e4987b58b |
| children | df836d6f9c8a |
| rev | line source |
|---|---|
| 3022 | 1 .. _installation: |
| 2 | |
| 2946 | 3 ============ |
| 4 Installation | |
| 5 ============ | |
| 6 | |
|
3558
d8581c83fef3
doc (installation): update instruction to use requirements + fix name in a few places
Goffi <goffi@goffi.org>
parents:
3536
diff
changeset
|
7 This are the instructions to install Libervia using Python. |
| 3505 | 8 Note that if you are using GNU/Linux, Libervia may already be present on your distribution. |
| 2946 | 9 |
| 3505 | 10 Libervia is made of one backend, and several frontends. To use it, the first thing to do is to install the backend. |
| 2946 | 11 |
|
3260
e9ecd133773b
doc (installation): updated instructions for backend
Goffi <goffi@goffi.org>
parents:
3022
diff
changeset
|
12 We recommand to use development version for now, until the release of 0.8. |
| 2946 | 13 |
| 14 Development version | |
| 15 ------------------- | |
| 16 | |
| 17 *Note for Arch users: a pkgbuild is available for your distribution on | |
| 18 AUR, check sat-xmpp-hg (as well as other sat-\* packages).* | |
| 19 | |
| 20 You can install the latest development version using pip. You need to | |
| 21 have the following dependencies installed first: | |
| 22 | |
|
3260
e9ecd133773b
doc (installation): updated instructions for backend
Goffi <goffi@goffi.org>
parents:
3022
diff
changeset
|
23 - Python 3 with development headers |
| 3383 | 24 - Python 3 "venv", which may already be installed with Python 3 |
| 2946 | 25 - Mercurial |
| 3383 | 26 - libcairo 2 with development header |
| 2946 | 27 - libjpeg with development headers |
| 28 - libgirepository 1.0 with development headers | |
| 29 - libdbus-1 with development headers | |
| 30 - libdbus-glib-1 with development headers | |
| 31 - libxml2 with development headers | |
| 32 - libxlt2 with development headers | |
| 33 - D-Bus x11 tools (this doesn't needs X11, it is just needed for dbus-launch) | |
| 34 - cmake | |
| 35 | |
| 36 On Debian and derivatives, you can get all this with following command:: | |
| 37 | |
|
3353
7726916c1ba6
doc: updated installation instructions
Goffi <goffi@goffi.org>
parents:
3260
diff
changeset
|
38 $ sudo apt-get install python3-dev python3-venv python3-wheel mercurial libxml2-dev libxslt-dev libcairo2-dev libjpeg-dev libgirepository1.0-dev libdbus-1-dev libdbus-glib-1-dev dbus-x11 cmake |
| 2946 | 39 |
| 3505 | 40 Now go in a location where you can install Libervia, for |
| 2946 | 41 instance your home directory:: |
| 42 | |
| 43 $ cd | |
| 44 | |
|
3558
d8581c83fef3
doc (installation): update instruction to use requirements + fix name in a few places
Goffi <goffi@goffi.org>
parents:
3536
diff
changeset
|
45 And enter the following commands (here we install Libervia with SVG support, which is needed to |
|
3260
e9ecd133773b
doc (installation): updated instructions for backend
Goffi <goffi@goffi.org>
parents:
3022
diff
changeset
|
46 display SVG avatars on some frontends):: |
| 2946 | 47 |
|
3563
267e4987b58b
doc: fix remaining SàT references/typos + add `libervia-cli` missing commands
Goffi <goffi@goffi.org>
parents:
3558
diff
changeset
|
48 $ python3 -m venv libervia |
|
267e4987b58b
doc: fix remaining SàT references/typos + add `libervia-cli` missing commands
Goffi <goffi@goffi.org>
parents:
3558
diff
changeset
|
49 $ source libervia/bin/activate |
|
3558
d8581c83fef3
doc (installation): update instruction to use requirements + fix name in a few places
Goffi <goffi@goffi.org>
parents:
3536
diff
changeset
|
50 $ pip install -U pip wheel |
|
d8581c83fef3
doc (installation): update instruction to use requirements + fix name in a few places
Goffi <goffi@goffi.org>
parents:
3536
diff
changeset
|
51 $ pip install -r requirements.txt |
| 2946 | 52 |
|
3558
d8581c83fef3
doc (installation): update instruction to use requirements + fix name in a few places
Goffi <goffi@goffi.org>
parents:
3536
diff
changeset
|
53 Don't worry if you see the following message, Libervia should work anyway:: |
| 2946 | 54 |
| 55 Failed building wheel for pygobject | |
| 56 | |
|
3558
d8581c83fef3
doc (installation): update instruction to use requirements + fix name in a few places
Goffi <goffi@goffi.org>
parents:
3536
diff
changeset
|
57 After installing Libervia, you need to install the media:: |
| 2946 | 58 |
| 59 $ cd | |
| 60 $ hg clone https://repos.goffi.org/sat_media | |
| 61 | |
|
3563
267e4987b58b
doc: fix remaining SàT references/typos + add `libervia-cli` missing commands
Goffi <goffi@goffi.org>
parents:
3558
diff
changeset
|
62 then, create the directory ``~/.config/libervia``:: |
|
3353
7726916c1ba6
doc: updated installation instructions
Goffi <goffi@goffi.org>
parents:
3260
diff
changeset
|
63 |
|
3563
267e4987b58b
doc: fix remaining SàT references/typos + add `libervia-cli` missing commands
Goffi <goffi@goffi.org>
parents:
3558
diff
changeset
|
64 $ mkdir -p ~/.config/libervia |
|
3353
7726916c1ba6
doc: updated installation instructions
Goffi <goffi@goffi.org>
parents:
3260
diff
changeset
|
65 |
|
3563
267e4987b58b
doc: fix remaining SàT references/typos + add `libervia-cli` missing commands
Goffi <goffi@goffi.org>
parents:
3558
diff
changeset
|
66 and the file ``~/.config/libervia/libervia.conf`` containing: |
| 2946 | 67 |
| 68 .. sourcecode:: cfg | |
| 69 | |
| 70 [DEFAULT] | |
| 71 media_dir = ~/sat_media | |
| 72 | |
| 73 Of course, replace ``~/sat_media`` with the actual path you have used. | |
| 74 | |
|
3260
e9ecd133773b
doc (installation): updated instructions for backend
Goffi <goffi@goffi.org>
parents:
3022
diff
changeset
|
75 You can check :ref:`configuration` for details |
| 2946 | 76 |
| 77 Usage | |
| 78 ===== | |
| 79 | |
|
3563
267e4987b58b
doc: fix remaining SàT references/typos + add `libervia-cli` missing commands
Goffi <goffi@goffi.org>
parents:
3558
diff
changeset
|
80 To launch the Libervia backend, enter:: |
| 2946 | 81 |
|
3563
267e4987b58b
doc: fix remaining SàT references/typos + add `libervia-cli` missing commands
Goffi <goffi@goffi.org>
parents:
3558
diff
changeset
|
82 $ libervia-backend |
| 2946 | 83 |
| 84 …or, if you want to launch it in foreground:: | |
| 85 | |
|
3563
267e4987b58b
doc: fix remaining SàT references/typos + add `libervia-cli` missing commands
Goffi <goffi@goffi.org>
parents:
3558
diff
changeset
|
86 $ libervia-backend fg |
| 2946 | 87 |
| 88 You can stop it with:: | |
| 89 | |
|
3563
267e4987b58b
doc: fix remaining SàT references/typos + add `libervia-cli` missing commands
Goffi <goffi@goffi.org>
parents:
3558
diff
changeset
|
90 $ libervia-backend stop |
| 2946 | 91 |
| 92 To know if backend is launched or not:: | |
| 93 | |
|
3563
267e4987b58b
doc: fix remaining SàT references/typos + add `libervia-cli` missing commands
Goffi <goffi@goffi.org>
parents:
3558
diff
changeset
|
94 $ libervia-backend status |
| 2946 | 95 |
|
3558
d8581c83fef3
doc (installation): update instruction to use requirements + fix name in a few places
Goffi <goffi@goffi.org>
parents:
3536
diff
changeset
|
96 **NOTE**: if ``misc/org.libervia.Libervia.service`` is installed correctly (which should |
|
d8581c83fef3
doc (installation): update instruction to use requirements + fix name in a few places
Goffi <goffi@goffi.org>
parents:
3536
diff
changeset
|
97 be done by during the installation), the backend is automatically launched when a frontend |
|
d8581c83fef3
doc (installation): update instruction to use requirements + fix name in a few places
Goffi <goffi@goffi.org>
parents:
3536
diff
changeset
|
98 needs it. |
| 2946 | 99 |
|
3558
d8581c83fef3
doc (installation): update instruction to use requirements + fix name in a few places
Goffi <goffi@goffi.org>
parents:
3536
diff
changeset
|
100 You can check that Libervia is installed correctly by trying jp (the backend need to be |
|
d8581c83fef3
doc (installation): update instruction to use requirements + fix name in a few places
Goffi <goffi@goffi.org>
parents:
3536
diff
changeset
|
101 launched first, check below):: |
| 2946 | 102 |
|
3558
d8581c83fef3
doc (installation): update instruction to use requirements + fix name in a few places
Goffi <goffi@goffi.org>
parents:
3536
diff
changeset
|
103 $ li --version |
|
d8581c83fef3
doc (installation): update instruction to use requirements + fix name in a few places
Goffi <goffi@goffi.org>
parents:
3536
diff
changeset
|
104 Libervia CLI 0.8.0D « La Cecília » (rev 184c66256bbc [M] (default 2021-06-09 11:35 +0200) +524) Copyright (C) 2009-2021 Jérôme Poisson, Adrien Cossa |
| 2946 | 105 This program comes with ABSOLUTELY NO WARRANTY; |
| 106 This is free software, and you are welcome to redistribute it under certain conditions. | |
| 107 | |
|
3558
d8581c83fef3
doc (installation): update instruction to use requirements + fix name in a few places
Goffi <goffi@goffi.org>
parents:
3536
diff
changeset
|
108 If you have a similar output, Libervia is working. |
| 2946 | 109 |
|
3353
7726916c1ba6
doc: updated installation instructions
Goffi <goffi@goffi.org>
parents:
3260
diff
changeset
|
110 .. note:: |
|
7726916c1ba6
doc: updated installation instructions
Goffi <goffi@goffi.org>
parents:
3260
diff
changeset
|
111 |
|
7726916c1ba6
doc: updated installation instructions
Goffi <goffi@goffi.org>
parents:
3260
diff
changeset
|
112 if you have the message ``/!\ D-Bus is not launched, please see README to see |
|
7726916c1ba6
doc: updated installation instructions
Goffi <goffi@goffi.org>
parents:
3260
diff
changeset
|
113 instructions on how to launch it`` that mean that the D-Bus service is not launched, this |
|
3558
d8581c83fef3
doc (installation): update instruction to use requirements + fix name in a few places
Goffi <goffi@goffi.org>
parents:
3536
diff
changeset
|
114 usually happens when launching Libervia on a server, without graphic interface like X.org or |
|
3353
7726916c1ba6
doc: updated installation instructions
Goffi <goffi@goffi.org>
parents:
3260
diff
changeset
|
115 Wayland (in which case D-Bus service should be launcher automatically). |
|
7726916c1ba6
doc: updated installation instructions
Goffi <goffi@goffi.org>
parents:
3260
diff
changeset
|
116 |
|
7726916c1ba6
doc: updated installation instructions
Goffi <goffi@goffi.org>
parents:
3260
diff
changeset
|
117 As the message states, instructions on how to launch the service are given in the README |
| 3505 | 118 file of Libervia. |
|
3353
7726916c1ba6
doc: updated installation instructions
Goffi <goffi@goffi.org>
parents:
3260
diff
changeset
|
119 |
| 2946 | 120 Frontends |
| 121 ========= | |
| 122 | |
| 123 So far, the following frontends exist and are actively maintained: | |
| 124 | |
|
3558
d8581c83fef3
doc (installation): update instruction to use requirements + fix name in a few places
Goffi <goffi@goffi.org>
parents:
3536
diff
changeset
|
125 Libervia Desktop (aka Cagou) |
| 2946 | 126 desktop/mobile (Android) frontend |
| 127 | |
|
3558
d8581c83fef3
doc (installation): update instruction to use requirements + fix name in a few places
Goffi <goffi@goffi.org>
parents:
3536
diff
changeset
|
128 Libervia Web |
| 2946 | 129 the web frontend |
| 130 | |
|
3558
d8581c83fef3
doc (installation): update instruction to use requirements + fix name in a few places
Goffi <goffi@goffi.org>
parents:
3536
diff
changeset
|
131 Libervia TUI (aka Primitivus) |
| 2946 | 132 Text User Interface |
| 133 | |
|
3558
d8581c83fef3
doc (installation): update instruction to use requirements + fix name in a few places
Goffi <goffi@goffi.org>
parents:
3536
diff
changeset
|
134 Libervia CLI (aka jp or li) |
| 2946 | 135 Command Line Interface |
| 136 | |
|
3558
d8581c83fef3
doc (installation): update instruction to use requirements + fix name in a few places
Goffi <goffi@goffi.org>
parents:
3536
diff
changeset
|
137 To launch Libervia TUI, just type:: |
| 2946 | 138 |
|
3558
d8581c83fef3
doc (installation): update instruction to use requirements + fix name in a few places
Goffi <goffi@goffi.org>
parents:
3536
diff
changeset
|
139 $ libervia-tui |
| 2946 | 140 |
| 141 then create a profile (XMPP account must already exist). | |
| 142 | |
|
3558
d8581c83fef3
doc (installation): update instruction to use requirements + fix name in a few places
Goffi <goffi@goffi.org>
parents:
3536
diff
changeset
|
143 To use Libervia CLI, follow its help (``li`` is a shortcut for ``libervia-cli``):: |
| 2946 | 144 |
|
3558
d8581c83fef3
doc (installation): update instruction to use requirements + fix name in a few places
Goffi <goffi@goffi.org>
parents:
3536
diff
changeset
|
145 $ li --help |
| 2946 | 146 |
| 147 | |
| 148 There are some other frontends: | |
| 149 | |
| 150 Bellaciao | |
| 151 based on Qt, a rich desktop frontend (currently on hold) | |
| 152 | |
| 153 Wix | |
| 154 former desktop frontend based on WxWidgets (deprecated with version 0.6.0) | |
| 155 | |
| 156 Sententia | |
| 157 Emacs frontend developed by a third party (development is currently stalled) |