====== Jitsi-Meet ======

Ziel: Aufsetzen einer Zweier-Konferenz, die dann als Stream abgegriffen 
werden kann und als Quelle für OBS verwendet werden kann.

Aufsetzen eines eigenen Servers mit Debian und bereits vorhandenem [[nginx]]
und [[lets_encrypt|Lets'-Encrypt]]-Zertifikat.

===== Installation =====

Prinzipielle Installationsschritte
  * Repository-Key von Jitsi in apt einbauen
  * Paketliste aktualisieren
  * Jitsi-Meet aus dem Repository installieren<code>
apt-get install jitsi-meet authbind
</code>

Nach der Installation ist das Webfrontend unter ''/usr/share/jitsi-meet''
zu finden. Das Web-Root eines in nginx anzulegenden Virtuellen Servers
ist entsprechend einzustellen.

Als Dämonen sind vorhanden
  * ''jicofo'' \\ Java-Programm, läuft unter dem Benutzer ''jicofo'' \\ Port ''5401''
  * ''jitsi-videobridge'' \\ Java-Programm, läuft unter dem Benutzer ''jvb''
  * ''prosody'' \\ LuaProgramm, XMPP-Server\\ Ports ''5222 (c2s), 5269 (s2s), 5280 (http), 5281 (https), 5347 (component)''
  * ''nginx'' \\ Ports ''80, 443''

==== Prosody ====

In unveränderter Konfiguration erscheinen Fehler im Protokoll: portmanager auf Port 5081 (https).
Das Problem kann gefixt werden indem in der Konfiguration hinter ''consider_bosh_secure = true;''
die Zertifikatskonfiguration eingefügt wird:<code>
https_certificate = ...
https_key = ...
</code>



==== Zertifikate ====

<WRAP center round todo 60%>
Baustelle! Dieser Abschnitt ist noch nicht vollständig und endgültig getestet.
</WRAP>


Tauschen der selbstsignierten Zertifikate gegen Eigene:
<code bash>
cd /etc/jitsi/meet
mv meet.example.com.crt meet.example.com.crt_orig
mv meet.example.com.key meet.example.com.key_orig
ln -s /etc/ssl/certs/jitsi.crt meet.example.com.crt
ln -s /etc/ssl/private/jitsi.key meet.example.com.key
</code>

Prosody-Konfiguration anpassen, Referenzen auf die korrekten Zertifikate
  /etc/prosody/conf.avail/meet.example.com.cfg.lua

===== Konfiguration =====

Siehe dazu: ''/usr/share/jitsi-meet-web-config''

++++ Nginx Konfigurationsdatei |
<file conf /etc/nginx/sites-available/jitsi>
server {
	listen 80;
	server_name meet.example.com;

	root /usr/share/jitsi-meet;

	index index.html;

        # Let's Encrypt
        location ^~ /.well-known/acme-challenge/ {
                default_type "text/plain";
                alias /var/www/lets_encrypt/challenges/;
        }
        location = /.well-known/acme-challenge/ {
                return 404;
        }

	location / {
		return 301 https://meet.example.com.de$request_uri;
	}

}

server {
	listen 443 ssl;
	server_name meet.example.com;

	ssl on;
	ssl_certificate /etc/ssl/certs/jitsi.crt;
	ssl_certificate_key /etc/ssl/private/jitsi.key;

# WIP

</file>
++++

===== Customizing =====

  * Einstellungen in /etc/jitsi/meet/
    * ''meet.example.com-config.js''
      * Standardsprache per ''language'' einstellen
  * Basisverzeichnis ist ''/usr/share/jitsi-meet''
    * GUI-Einstellungen: ''interface_config.js''
    * Bilder in ''images'' können ausgetauscht werden
    * Texte in ''lang'' können angepaßt werden: 
      * ''main-de.json''
        * welcomepage / title: "Piratenpartei Schleswig-Holstein Videokonferenzen"
        * welcomepage / appDescription: "Hier kommunizieren Piraten mit Bild. Für Veranstaltungen nur mit Ton bitte Mumble benutzen."