So passen Sie die Benutzeroberfläche und das Logo von BigBlueButton individuell an.

BigBlueButton-Branding kann drei verschiedene Dinge bedeuten: das Logo auf der Standard-Webseite des Servers ändern, ein Logo in einem Meeting anzeigen oder den Meeting-Client selbst neu gestalten. Wählen Sie die kleinste Änderung, die Ihr Ziel erreicht. Die ersten beiden sind dokumentierte Konfigurations- oder Asset-Änderungen; eine Überarbeitung des Farbschemas, der Formulierung oder des Client-Layouts erfordert in der Regel die Entwicklung eines benutzerdefinierten HTML5-Clients.

Diese Anleitung orientiert sich an der BigBlueButton 4.0-Administrationsdokumentation vom 6. Oktober 2026. Pfade und Bereitstellungspakete können je nach Version oder Hosting-Anbieter variieren. Prüfen Sie die auf Ihrem Server installierte Version, bevor Sie Dateien ändern, und erstellen Sie vorher eine Sicherungskopie.

Wählen Sie die Markenänderung, die Sie benötigen

Das Logo auf der Server-Startseite und das Logo im Meeting sind getrennt. Wenn das eine ersetzt wird, wird das andere nicht automatisch ersetzt.

Bevor Sie den Server bearbeiten

Sie benötigen Shell-Zugriff mit entsprechenden Berechtigungen, um Änderungen am BigBlueButton-Server vorzunehmen. Außerdem sollten Sie wissen, ob der Server von Ihnen selbst oder von einem Managed Service verwaltet wird. Falls ein Provider den Server betreibt, fragen Sie nach, ob dieser benutzerdefiniertes Branding unterstützt und ob die Änderungen bei Wartungsarbeiten erhalten bleiben.

• Prüfen Sie Ihre installierte Version und vergleichen Sie sie mit der entsprechenden Anleitung zur Anpassung des BigBlueButton-Servers .
• Speichern Sie eine Kopie des aktuellen Logos und aller Konfigurationsdateien, die Sie bearbeiten möchten.
• Erstellen Sie eine saubere Logodatei, die in der auf Ihrer Website oder in Ihrem Meeting verwendeten Größe gut erkennbar ist. Da die Dokumentation keine universelle Pixelgröße vorgibt, überprüfen Sie den tatsächlichen Anzeigebereich und verlassen Sie sich nicht auf angenommene Abmessungen.
• Verwenden Sie eine Bild-URL, die die Meeting-Teilnehmer ohne Anmeldung aufrufen können. Bevorzugen Sie HTTPS und überprüfen Sie die URL von außerhalb des Servers, bevor Sie sie verwenden.

Ändern Sie das Standard-Webseitenlogo

Für BigBlueButton 4.0 ist im Administrationshandbuch das Standardlogo unter [URL] angegeben /var/www/bigbluebutton-default/assets/images/logo.png. Dies betrifft die vom Server bereitgestellte Standardwebsite. Das im HTML5-Meeting-Client angezeigte Logo wird dadurch nicht festgelegt.

1. Stellen Sie eine Verbindung zum Server her und prüfen Sie, ob die Datei im angegebenen Pfad vorhanden ist. Falls der Pfad abweicht, halten Sie inne und konsultieren Sie die Dokumentation Ihrer installierten Version, anstatt die Datei in ein vermutetes Verzeichnis zu kopieren.
2. Sichern Sie die vorhandene Ressource. Ein Administrator kann sie beispielsweise vor dem Ersetzen in eine datierte Sicherungsdatei im selben Verzeichnis kopieren. Beachten Sie bei der Installation der Ersatzressource die ursprünglichen Berechtigungen und Eigentümerverhältnisse.
3. Platzieren Sie Ihr neues Logo an der angegebenen Stelle unter Verwendung des Dateinamens logo.png. Prüfen Sie, ob es sich bei der Bilddatei tatsächlich um eine PNG-Datei handelt und ob der Kontrast zum Seitenhintergrund ausreichend ist.
4. Öffnen Sie die öffentliche BigBlueButton-Startseite in einem privaten Browserfenster oder leeren Sie den Browser-Cache. Prüfen Sie, ob die neue Markierung ohne Verzerrungen, abgeschnittene Stellen oder Unschärfe angezeigt wird.

Die offizielle Anleitung gibt zwar den Speicherort der Assets an, garantiert aber nicht, dass ein lokaler Ersatz nach jedem Paketupdate erhalten bleibt. Bewahren Sie Ihre Original- und Ersatzdateien in Ihren Bereitstellungsaufzeichnungen auf und überprüfen Sie die Startseite nach Aktualisierungen erneut. Falls das Logo nach einem Update verschwindet, vergleichen Sie die installierte Datei mit Ihrem gespeicherten Asset und wenden Sie die Änderung erst dann erneut an, nachdem Sie die Anweisungen der aktuellen Version geprüft haben.

Zeigen Sie ein Logo in Meetings

Die dokumentierte Option von BigBlueButton, das Branding pro Meeting festzulegen, platziert ein Logo im Branding-Bereich oberhalb der Teilnehmerliste. Dafür müssen zwei Bedingungen erfüllt sein: Die displayBrandingAreaentsprechende Einstellung im HTML5-Client muss aktiviert sein und das Meeting muss mit einer logoBild-URL erstellt worden sein. Ein Logo-Parameter allein reicht nicht aus, um einen versteckten Branding-Bereich anzuzeigen.

1. Aktivieren Sie in der HTML5-Clientkonfiguration die entsprechende Option displayBrandingArea. Bei den aktuell dokumentierten Installationen /etc/bigbluebutton/bbb-html5.ymlist die empfohlene lokale Überschreibungsdatei; die dortigen Konfigurationseinträge überschreiben die entsprechenden Einstellungen des mitgelieferten Clients. Behalten Sie beim Bearbeiten der Datei alle anderen vorhandenen YAML-Werte bei.
2. Starten Sie BigBlueButton neu, damit die Konfigurationsänderung wirksam wird sudo bbb-conf --restart. Planen Sie dies während eines geeigneten Wartungsfensters ein, da ein Neustart laufende Meetings unterbrechen kann.
3. Wenn Ihre Anwendung oder Ihr API-Client das Meeting erstellt, fügen Sie einen benutzerdefinierten Parameter in das Formular ein logo=https://your-domain.example/brand.png. Die genaue Stelle, an der Sie diesen Parameter eingeben, hängt von der Integration ab, die die BigBlueButton- /createAnfrage sendet. Befolgen Sie die Anweisungen dieser Integration und geben Sie das gemeinsame Geheimnis Ihres Servers nicht im clientseitigen Code preis.
4. Erstellen Sie ein neues Testmeeting und nehmen Sie daran teil. Prüfen Sie, ob das Logo über der Teilnehmerliste angezeigt wird und ob das Bild auch für Teilnehmer geladen wird, die nicht beim Bildhost angemeldet sind.

Die empfohlenen Speicherorte für Überschreibungen finden Sie in der offiziellen Konfigurationsdateireferenz und die API-Referenz für Parameter zur Meeting-Erstellung. Verwenden Sie die Dokumentation, die zu Ihrer Serverversion passt, falls diese nicht 4.0 ist.

Wenn Sie ein komplettes Rebranding Ihrer Benutzeroberfläche benötigen

Ein Logo im Branding-Bereich des Meetings ist nicht dasselbe wie eine White-Label-Meeting-Anwendung. Wenn Sie Farben, Beschriftungen oder andere integrierte Client-Elemente der Benutzeroberfläche ersetzen möchten, finden Administratoren in den FAQs von BigBlueButton Anweisungen zur Einrichtung der Entwicklungsumgebung und zur Erstellung einer eigenen Version des HTML5-Clients. Die Branding-FAQ und der Entwicklungsleitfaden des Projekts dienen als Ausgangspunkt.

Dieser Ansatz erfordert Entwicklungs- und Bereitstellungsaufwand. Es handelt sich nicht um eine schnelle Serverkonfiguration, und Änderungen können im Zuge der Weiterentwicklung von BigBlueButton Wartungsarbeiten erforderlich machen. Bevor Sie in eine individuelle Anpassung investieren, notieren Sie genau, welche Bildschirme oder Elemente geändert werden müssen, und prüfen Sie, ob die integrierten Optionen für die Startseite oder das Meeting-Logo ausreichen. Falls Sie fortfahren, speichern Sie die Anpassung in der Versionskontrolle, dokumentieren Sie die Vorgehensweise zum Wiederherstellen und testen Sie Aktualisierungen in einer Testumgebung, bevor Sie die Produktionsumgebung aktualisieren.

Überprüfen Sie das Ergebnis und beheben Sie die Fehler anhand der Symptome.

• Das Logo der Landingpage hat sich nicht geändert: Stellen Sie sicher, dass Sie die Datei im bigbluebutton-defaultAssets-Verzeichnis des aktiven Servers ersetzt haben und deaktivieren Sie anschließend den Browser-Caching. Falls die öffentliche Seite über einen Proxy oder ein separates Portal bereitgestellt wird, prüfen Sie, welchem ​​System diese Seite gehört.
• Das Meeting-Logo wird nicht angezeigt: Überprüfen Sie, ob die Einstellung für den Branding-Bereich aktiviert ist, ob der Server neu gestartet wurde, ob das neue Meeting mit dem logoentsprechenden Parameter erstellt wurde und ob die Bild-URL für einen nicht authentifizierten Browser funktioniert.
• Das Logo wird zwar angezeigt, sieht aber fehlerhaft aus: Überprüfen Sie die Proportionen, Transparenzbereiche und den Kontrast des Quellbildes. Passen Sie das Quellbild an, anstatt es in der Benutzeroberfläche zu strecken.
• Manche Teilnehmer sehen einen leeren Bereich: Testen Sie die Bild-URL von einem anderen Netzwerk und Gerät aus. Eine Firewall, Zugriffsbeschränkungen, ein ungültiges TLS-Zertifikat oder eine ablaufende URL können verhindern, dass die Browser der Teilnehmer das Bild laden.
• Farben und Text bleiben unverändert: Ein Austausch des Serverlogos ändert nicht das Design des Meeting-Clients. Verwenden Sie die benutzerdefinierte Cliententwicklung, wenn diese Oberflächenelemente geändert werden müssen.

Beurteilen Sie den Erfolg anhand der Position und Konsistenz des Ergebnisses: Die Landingpage zeigt das neue Logo; in einem neu erstellten Testmeeting wird das Meeting-Logo im dokumentierten Branding-Bereich angezeigt; und falls Sie einen benutzerdefinierten Client erstellt haben, bleiben die gewünschten Änderungen der Benutzeroberfläche während des gesamten Anmelde- und Meeting-Prozesses erhalten. Ein kleines Testmeeting ist ein zuverlässigerer Validierungspunkt als die Überprüfung nur eines zwischengespeicherten Browser-Tabs.

Die Branding-Optionen von BigBlueButton sind auf Konfigurationsebene bewusst eingeschränkt. Die integrierten Logo-Pfade decken gängige Anforderungen an die Markenidentität ab, während eine vollständige Neugestaltung der Benutzeroberfläche die Nutzung eines kundenspezifischen Clients und dessen laufende Wartung erfordert.