From 95e6b0e5080a7c37df7d548e3a63aca227cdf5b6 Mon Sep 17 00:00:00 2001
From: Hans van Zijst <hans@procolix.com>
Date: Mon, 25 Nov 2024 15:11:53 +0100
Subject: [PATCH] Expanded documentation for Element Call.

---
 matrix/element-call/README.md | 37 +++++++++++++++++++++++++++++++----
 1 file changed, 33 insertions(+), 4 deletions(-)

diff --git a/matrix/element-call/README.md b/matrix/element-call/README.md
index 841277c..371745c 100644
--- a/matrix/element-call/README.md
+++ b/matrix/element-call/README.md
@@ -123,8 +123,8 @@ chgrp -R www-data /etc/lk-jwt-service
 chmod -R o-rwx /etc/lk-jwt-service
 ```
 
-The contents of `/etc/lk-jwt-service/config` are not fully known yet ([see
-further, installation of the actual LiveKit, the SFU](#generatekeys)), but for now it's enough
+The contents of `/etc/lk-jwt-service/config` are not fully known yet (see
+further, installation of the actual LiveKit, the SFU), but for now it's enough
 to fill it with this:
 
 ```
@@ -158,7 +158,7 @@ You can do this as a normal user, it will use sudo to do its job.
 Configuring this thing is [documented
 here](https://docs.livekit.io/home/self-hosting/deployment/).
 
-Create a key and secret: {#generatekeys}
+Create a key and secret:
 
 ```
 livekit-server generate-keys
@@ -170,7 +170,7 @@ configuration file for livekit, `/etc/livekit/livekit.yaml`:
 ```
 port: 7880
 bind_addresses:
-    - ""
+    - ::1
 rtc:
     tcp_port: 7881
     port_range_start: 50000
@@ -191,6 +191,11 @@ keys:
     xxxxxxxxxxxxxxx: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
 ```
 
+The LiveKit API listens on localhost, IPv6, port. This port is only used by
+lk-jwt-service, so it shouldn't be reachable from the outside world.
+
+The `xxx: xxxx` is the key and secret as generated before.
+
 Now define a systemd servicefile, like this:
 
 ```
@@ -261,3 +266,27 @@ cd element-call
 After that, you can find the whole shebang under "dist". Copy that to
 `/var/www/element-call` and point nginx to it ([see nginx](../nginx#callwidget)).
 
+It needs a tiny bit of configuring. The default configuration under `config/config.sample.json`
+is a good place to start, copy it to `/etc/element-call` and change where
+necessary:
+
+```
+{
+  "default_server_config": {
+      "m.homeserver": {
+          "base_url": "https://vm02199.matrixdev.example.com",
+          "server_name": "matrixdev.example.com"
+      }
+  },
+
+  "livekit": {
+    "livekit_service_url": "https://livekit.matrixdev.example.com"
+  },
+
+  "features": {
+    "feature_use_device_session_member_events": true
+  },
+
+  "eula": "https://www.example.com/online-EULA.pdf"
+}
+```