aboutsummaryrefslogtreecommitdiff
path: root/docs/admin/01_installation.rst
blob: 4b5b45ade5e069b6cd4523634153a8380fa36dcc (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
Installation
============

We recommend to use Debian-based systems for first tests.
Later there will be supported more operating systems,
but for now you should start with a Debian-like system.

At the beginning you should clone the source code:

::

    git clone https://gitlab.das-netzwerkteam.de/remotewebapp/rwa.support.sessionservice

As the next thing, use ``apt`` to install the core dependencies as debian packages:

::

	sudo apt install python3 python3-venv python3-pip x11vnc libcairo2-dev libdbus-glib-1-dev libgirepository1.0-dev wget git

To bundle the further dependencies of the D-Bus daemon,
we use Poetry to get them from the PyPI. So, install Poetry using PIP:

::

	sudo pip3 install poetry

Then use poetry to get all packages from PyPI necessary for running the service
(be sure that you are in the source code directory):

::

	poetry install


Now you can continue with :doc:`02_config`.

.. warning::

    As Poetry also manages your virtual environment, you must use
    ``poetry run`` everytime if you want to start something in your environment:

    **Example:**

    ::

        poetry run python test_client.py

        # or

        poetry run python tox