Big Blue Button auf VPS installieren

Lesedauer 6 Minuten

Diese Anleitung zeigt Dir, wie Du Schritt für Schritt das Open Source Video Chat System Big Blue Button installierst.

Inhaltsverzeichnis

• 0. Überblick
• 1. BigBlueButton installieren
• 2. Container erstellen
• 3. Container starten
• 4. Administrator anlegen
• 5. Administrator-Kennwort ändern

0. Überblick

• Verwendetes System: Debian 11 64 bit
• Genutzter User: Ich nehme alles als „root“ vor
• Testsystem: VPS General Purpose
• Zeitdauer: ca. 50 Minuten, je nach Serverleistung
• Schwierigkeit: Einfach. Nur Code kopieren 😉
• Besonderheiten:
  • Grundlage ist folgende Anleitung: Traefik Reverseproxy installieren Diese Anleitung muss zuerst ausgeführt werden.
  • Die Installation von Docker / Docker Compose wird hier vorausgesetzt.

1. BigBlueButton installieren

1.1 Einleitung

BigBlueButton ist ein open Source Webkonferenzsystem. Die Besonderheit von BigBlueButton ist, dass es sich in viele Lernsysteme integrieren lässt, weshalb aktuell viele Bundesländer BigBlueButton nutzen. BigBlueButton kann auf dem eigenen Server betrieben werden, wodurch der Datenschutz besser gewährleistet werden kann.

1.2 Systemvoraussetzungen

BigBlueButton hat ziemlich hohe Systemvoraussetzungen. Diese kannst du hier nachlesen:

https://docs.bigbluebutton.org/2.2/install.html

Ich habe es hier mit einem VPS mit 4 CPUs und 6GB RAM getestet. BigBlueButton lässt sich mit 3 Leuten in einer Videokonferenz ohne Probleme nutzen. In machen Situationen (z.B. Hochladen einer Präsentation / PDF) merkt man jedoch, dass alle CPUs zu 100% ausgelastet sind. Man benötigt also einen sehr leistungsstarken Server, wenn man BigBlueButton mit vielen Leuten nutzen möchte.

1.3 Infos zu yml Dateien

Bei yml Dateien ist es sehr wichtig, dass die Zeilen alle richtig eingerückt sind. Die Zeilen MÜSSEN immer mit der Leertaste eingerückt werden. Es dürfen KEINE Tabs enthalten sein. Du kannst den nachfolgenden Code immer online „überprüfen“ lassen. Die meisten Fehler entstehen nämlich durch die falsche Formatierung. Ein Dienst zum Überprüfen ist zum Beispiel: https://codebeautify.org/yaml-validator

1.4 Vorbereitung

Diese Anleitung basiert auf dem aktuellen Debian 10 Betriebssystem. BigBlueButton werden wir unter Docker realisieren. Dies ermöglicht uns später sehr schnelle Updates und eine schnelle Installation. Ebenfalls haben wir den enormen Vorteil, dass wir kein bestimmtes Betriebssystem nutzen müssen. Würden wir BigBlueButton normal installieren, so müssen wir eine bestimmte Ubuntu Version nutzen.

Um BigBlueButton neben anderen Diensten auf unserem Server betreiben zu können, nutzen wir hier den Reverse Proxy Traefik. Die Anleitung dazu findest du hier: https://www.easyname.at/blog/vps/anwendungen/traefik-reverseproxy-auf-vps-installieren

1.4.1 Daten von git kopieren

Nun kopieren wir uns die aktuelle Version von BigBlueButton. Dazu gibst du folgendes ein.

apt-get update
apt-get install git
git clone -b main --recurse-submodules [https://github.com/bigbluebutton/docker.git /opt/containers/bigbluebutton/](https://github.com/bigbluebutton/docker.git%20/opt/containers/bigbluebutton/)
cd /opt/containers/bigbluebutton
git submodule update --init

Dabei werden die Daten ins Verzeichnis /opt/containers/bigbluebutton kopiert. Du kannst hier auch ein anderes Verzeichnis verwenden. Musst dann aber die gesamte Anleitung entsprechend anpassen.

1.4.2 Setup ausführen

Nachdem wir uns die aktuelle Version von BigBlueButton installiert haben, beginnen wir das Setup auszuführen. Dabei werden bestimmte Einstellungen an unseren Server angepasst. Gib dazu folgendes ein:

./scripts/setup

Als erstes wirst du gefragt, ob du Greenlight (https://bigbluebutton.org/2018/07/09/greenlight-2-0/) installieren willst. Bei Greenlight handelt es sich um eine bequeme Weboberfläche. Daher bestätige ich das mit „y“.

Should greenlight be included? (y/n): y

Als nächstes wirst du gefragt, ob du einen HTTPS Proxy nutzen möchtest. Da wir bereits Traefik nutzen, benötigen wir keinen weiteren.

Should an automatic HTTPS Proxy be included? (y/n): n

Als nächstes werden wir gefragt, ob wir „coturn“ (https://github.com/coturn/coturn), einen TURN und STUN Server installieren möchten. Diesen benötigen wir nicht.

Should a coturn be included? (y/n): n

Nun müssen wir noch unsere Domain angeben, über welche später BigBlueButton erreichbar sein soll. Meine lautet: video.testbereich.net

Please enter the domain name: video.testbereich.net

Nun werden wir noch gefragt, ob es möglich sein soll die Videokonferenzen aufzuzeichnen. Dies wollen wir nicht, da dies zu Datenschutz Problemen führen kann.

Choice (y/n): n

Jetzt können wir wählen, ob wir die Daten an Prometheus exportieren möchten. Prometheus kann diese Daten sammeln und wir könnten sie mit anderen Programmen wie Grafana darstellen. Dies benötigen wir hier aber auch nicht. 

Should a Prometheus exporter be included? (y/n): n 

Als nächstes müssen wir nur noch unsere IP-Adresse bestätigen.

Is 178.250.170.125 your external IPv4 address? (y/n): y

Hier der gesamte Dialog.

1.4.3 weiter Einstellungen anpassen (optional)

Nun kannst du noch weitere Einstellungen anpassen. Ich werde dies jedoch nicht tun. Du kannst das einfach in folgender Datei machen.

nano .env

Wenn du etwas verändert hast, so musst du dir eine neue docker-compose.yml erzeugen lassen.

Dies geht mit folgendem Befehl:

./scripts/generate-compose

1.4.4 docker-compose.override.yml erstellen

Nun erstellen wir eine neue Datei, damit wir BigBlueButton zusammen mit Traefik nutzen können. Dazu gibst du folgendes ein.

nano docker-compose.override.yml

Dort gibst du folgendes ein:

version: '3' 

services: 

    nginx: 

     labels: 

      - "traefik.enable=true" 

      - "traefik.http.routers.bbb.entrypoints=http" 

      - "traefik.http.routers.bbb.rule=Host(`video.euredomain.de`)" 

      - "traefik.http.middlewares.bbb-https-redirect.redirectscheme.scheme=https" 

      - "traefik.http.routers.bbb.middlewares=bbb-https-redirect" 

      - "traefik.http.routers.bbb-secure.entrypoints=https" 

      - "traefik.http.routers.bbb-secure.rule=Host(`video.euredomain.de`)" 

      - "traefik.http.routers.bbb-secure.tls=true" 

      - "traefik.http.routers.bbb-secure.tls.certresolver=http" 

      - "traefik.http.routers.bbb-secure.service=bbb" 

      - "traefik.http.services.bbb.loadbalancer.server.port=48087" 

      - "traefik.http.routers.bbb-secure.middlewares=secHeaders@file" 

      - "traefik.docker.network=proxy" 

     networks: 

      - proxy 

      - bbb-net 

 

networks: 

  proxy: 

    external: true 

 

1.4.5 Hostname anpassen

Nun passen wir den Hostnamen an. Gib hier den Namen an, welchen du auch im Schritt 1.4.2 als Domain angeben hast.

vorher:

- "traefik.http.routers.bbb.rule=Host(video.euredomain.de`)"
- "traefik.http.routers.bbb-secure.rule=Host(video.euredomain.de`)"

angepasst:

- "traefik.http.routers.bbb.rule=Host(video.testbereich.net`)"
- "traefik.http.routers.bbb-secure.rule=Host(video.testbereich.net`)"

1.4.6 Zeile aus docker-compose.yml löschen

Nun löschen wir noch eine Zeile aus der bisherigen docker-compose Datei.

Dazu öffnen wir die Datei:

nano docker-compose.yml

Scrolle bis Zeile 150. Dort steht „network_mode: host“. Diese Zeile entfernst du. Dazu gehst du in diese Zeile und drückst einfach „STRG+K“. Danach sollte es so aussehen.

1.4.7 kleines Bugfix

Die zur Zeit der Anleitung aktuelle Version hat einen Bug, weshalb es später beim der Imageerstellung zu einem Fehler kommt. Diesen kannst du folgendermaßen beheben. Öffne dazu folgende Datei: 

nano mod/webrtc-sfu/bbb-webrtc-sfu/package.json 

Jetzt siehst du folgendes: 

Wenn die Version wie hier < 3.10.3 ist, dann ändert es folgendermaßen ab:

2. Container erstellen

Nun werden wir unsere Container erstellen lassen. Dieser Vorgang hat bei meinem Server (4 CPUs und 6GB Ram) ca. 30 Minuten gedauert. Also sei geduldig, auch wenn es zwischenzeitlich so aussieht, als würde nichts mehr passieren. Wichtig ist hier zu wissen, dass ca. 18 verschiedene Container erstellt werden. Dies benötigt Zeit.

Um die Container zu erstellen, gibst du folgenden Befehl ein:

docker compose build 

Anschließend laden wir uns die restlichen Container noch herunter. Dazu geben wir folgendes ein: 

docker compose pull 

3. Container starten

Nachdem deine Container erstellt sind, können wir diese starten. Dazu gibst du folgendes ein:

docker compose up -d 

Jetzt werden alle 18 Container gestartet. Dies kann einige Zeit dauern. Nach 2-3 Minuten kannst du dann auf deine Webseite gehen. Bei mir ist dies https://video.testbereich.net.

4. Administrator anlegen

Nachdem du nun BigBlueButton gestartet hast und die Webseite erreichbar ist, kannst du einen Administrator anlegen. Wichtig ist, dass der Container in dieser Zeit laufen muss. Beendet diesen also NICHT.

Um einen Administrator anzulegen, gibst du folgenden Befehl ein:

docker exec bigbluebutton-greenlight-1 bundle exec rake admin:create 

Nun bekommst du folgendes angezeigt:

Mit diesen Daten kannst du dich nun anmelden und solltest folgendes sehen:

5. Administrator-Kennwort ändern

Nachdem du dich angemeldet hast, solltest du unbedingt dein Kennwort ändern. Klicke dazu auf deinen Account rechts oben und wähle „Profil“ aus.

Hier kannst du nun deinen Namen sowie die E-Mail-Adresse anpassen.

Unter dem Reiter „Passwort“ kannst du dann ein neues, sicheres Kennwort vergeben.