diff options
Diffstat (limited to 'docs/admin/01_installation.rst')
-rw-r--r-- | docs/admin/01_installation.rst | 45 |
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 + |