aboutsummaryrefslogtreecommitdiff
path: root/docs/admin/01_installation.rst
diff options
context:
space:
mode:
Diffstat (limited to 'docs/admin/01_installation.rst')
-rw-r--r--docs/admin/01_installation.rst45
1 files changed, 45 insertions, 0 deletions
diff --git a/docs/admin/01_installation.rst b/docs/admin/01_installation.rst
new file mode 100644
index 0000000..064cce9
--- /dev/null
+++ b/docs/admin/01_installation.rst
@@ -0,0 +1,45 @@
+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.
+
+As a first step 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
+
+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
+