Add config and docs for activation by D-Bus

1 files changed, 23 insertions, 0 deletions

diff --git a/docs/admin/04_dbus.rst b/docs/admin/04_dbus.rst
new file mode 100644
index 0000000..b9a1c5f
--- /dev/null
+++ b/docs/admin/04_dbus.rst
@@ -0,0 +1,23 @@
+Installation with D-Bus activation
+==================================
+
+The recommended way to install the RWA Session Service is as
+systemd unit file started by the D-Bus daemon automatically.
+
+As a first step use ``apt`` to globally install the dependencies as debian packages:
+
+::
+
+	sudo apt install python3 python3-venv python3-pip x11vnc libcairo2-dev libdbus-glib-1-dev libgirepository1.0-dev wget \
+        python3-flask python3-requests python3-port-for python3-websockify python3-dbus python3-gi python3-psutil
+
+Then make sure the source code is located in ``/opt/rwa-session-service``, so the service can reach it.
+
+As last thing, you have to create a symlink (or copy the file) to ``org.ArcticaProject.RWA.service``.
+
+::
+
+    sudo ln -s /opt/rwa-session-service/org.ArcticaProject.RWA.service /usr/share/dbus-1/services/org.ArcticaProject.RWA.service
+
+With this installed, you can easily send commands to the dbus daemon, which then automatically will check if there is
+already running a service or if the service has to be started – no further action is required by you.
\ No newline at end of file