Mercurial > libervia-backend
annotate INSTALL @ 1561:c09429bf587f
README: removed "Privacy Warning" as external website is now only called after user agreement
author | Goffi <goffi@goffi.org> |
---|---|
date | Mon, 02 Nov 2015 22:02:41 +0100 |
parents | e2e75c3c7c7b |
children | 1128feb54180 |
rev | line source |
---|---|
885 | 1 You can install SàT automatically using easy_install or pip, and it is available in several GNU/Linux distributions. The full instructions are available on the wiki: http://wiki.goffi.org/wiki/Salut_%C3%A0_Toi |
1202 | 2 Below is are installation instructions, but please check the wiki which may be more up-to-date. |
885 | 3 |
587
952322b1d490
Remove trailing whitespaces.
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents:
548
diff
changeset
|
4 *** |
885 | 5 |
1202 | 6 You can automatically install SàT and its dependencies using easy_install or pip. You will however need to install Python's headers (needed to build some packages), WxPython which is available in most Gnu/Linux distributions, PyGObject and developments version of libxml2 and libxslt (to compile lxml python library). |
885 | 7 |
1202 | 8 NOTE: pyfeed and xe are mandatory dependencies, they should be on http://pypi.python.org (PYthon Package Index, the official repository for Python projects) and so being automatically installed; but they are not yet there (their author should do it soon), so you have to install them manually until then. |
1203
6e08ee45bf0a
misc: updated urls of pyxe an pyfeed
Matteo Cypriani <mcy@lm7.fr>
parents:
1202
diff
changeset
|
9 You can download them respectively on http://home.avvanta.com/%7Esteveha/pyfeed-0.7.4.tar.gz and http://home.avvanta.com/%7Esteveha/xe-0.7.4.tar.gz, then decompress them and do « python setup.py install » on both. |
1202 | 10 An other way is to use the (insecure) pip options --process-dependency-links and --allow-all-external when installing sat, options which will soon be (or already are) removed from pip. |
1191 | 11 |
12 | |
1202 | 13 The environment variable SAT_INSTALL customises the installation, it contains flags separated by spaces: |
14 - "nopreinstall" skips all preinstallation checks | |
15 - "autodeb" automatically installs missing packages on Debian-based distributions | |
16 - "nox" disables installation of X-based packages (WxWidgets), this is useful for servers | |
885 | 17 |
1202 | 18 WxPython and PyGobject are automatically installed on Debian-based distributions if "autodeb" option is set. Indeed, on Debian-based distribution, you can type (with the root account): |
885 | 19 |
20 # apt-get install python-pip python-dev libxml2-dev libxslt-dev | |
21 # SAT_INSTALL=autodeb pip install . | |
22 | |
23 On a *buntu, same commands with sudo: | |
24 | |
25 $ sudo apt-get install python-pip python-dev libxml2-dev libxslt-dev | |
1100
2be46f391cfa
setup: SAT_INSTALL environment variable handles "clean" and "purge" options
souliane <souliane@mailoo.org>
parents:
885
diff
changeset
|
26 $ sudo SAT_INSTALL=autodeb pip install . |
885 | 27 |
28 | |
29 After installing SàT, you need to install the media: | |
30 | |
31 $ mkdir -p ~/sat/media/destination/path | |
32 $ cd ~/sat/media/destination/path | |
33 wget ftp://ftp.goffi.org/sat_media/sat_media.tar.bz2 | |
34 tar -jxvf sat_media.tar.bz2 | |
35 | |
36 then, create a ~/.sat.conf file which contains: | |
37 | |
38 ### sat.conf ### | |
39 [DEFAULT] | |
40 media_dir=~/sat/media/destination/path | |
41 ### end sat.conf ### | |
42 | |
43 Of course, replace ~/sat/media/destination/path with the actual path you want to use. | |
1410
e2e75c3c7c7b
quick_frontend, primitivus: fixes a couple of issues:
souliane <souliane@mailoo.org>
parents:
1291
diff
changeset
|
44 Check the wiki for more information about this configuration file: http://wiki.goffi.org/wiki/Configuration/en |
885 | 45 |
46 You should now be able to launch sat: | |
47 - to launch the backend, enter | |
48 $ sat | |
49 - to stop the backend, enter: | |
50 $ sat stop | |
51 - to launch Primitivus, enter: | |
52 $ primitivus | |
53 then create a profile. | |
54 - to use jp, follow its help: | |
55 $ jp --help | |
56 | |
57 For Libervia, the web interface, check http://wiki.goffi.org/wiki/Libervia/en | |
58 | |
59 If you need help, come the SàT official XMPP room: sat@chat.jabberfr.org |