kevinveenbirkenbach/computer-playbook
1
0
Fork 0
mirror of https://github.com/kevinveenbirkenbach/computer-playbook.git synced 2025-10-10 02:38:10 +02:00
Code Issues Packages Projects Releases Wiki Activity
Files
bcee1fecdfd5ff47d920463b093d9a600e9eb162
computer-playbook/roles/web-app-bigbluebutton
History
Kevin Veen-Birkenbach bcee1fecdf feat(inventory): add random_hex_32 generator 
feat(bbb/schema): auto-generate etherpad_api_key; set fsesl_password to alphanumeric_32
test(unit): add InventoryManager tests (Option B) expecting feature-generated creds as plain strings
docs: full autocreation of credentials for BigBlueButton now enabled
See: https://chatgpt.com/share/68d69ee8-3fd4-800f-9209-60026b338934
2025-09-26 16:11:05 +02:00
..
config
Hardened BBB Version
2025-09-26 15:21:01 +02:00
files
Huge role refactoring/cleanup. Other commits will propably follow. Because some bugs will exist. Still important for longrun and also for auto docs/help/slideshow generation
2025-07-08 23:43:13 +02:00
filter_plugins
Implemented correct path replace not just for context: but also for build: paths
2025-08-11 18:46:02 +02:00
meta
Replaced .infinito.service and .infinito.timer by SOFTWARE_NAME suffix, optimized LICENSE link and update OIDC Realm and ID conf
2025-08-14 14:39:18 +02:00
schema
feat(inventory): add random_hex_32 generator
2025-09-26 16:11:05 +02:00
tasks
bbb: WIP—stabilize env/compose wiring & prep SFU override
2025-09-26 12:49:12 +02:00
templates
bbb: pin mediasoup to IPv4-only and single worker via compose override
2025-09-26 15:50:28 +02:00
users
Renamed general and mode constants and implemented a check to verify that constants are just defined ones over the whole repository
2025-08-13 19:11:14 +02:00
vars
bbb: WIP—stabilize env/compose wiring & prep SFU override
2025-09-26 12:49:12 +02:00
README.md
Refactored server roles for better readability
2025-09-01 18:08:35 +02:00
TODO.md
bbb: WIP—stabilize env/compose wiring & prep SFU override
2025-09-26 12:49:12 +02:00

README.md

BigBlueButton

Description

This Ansible role deploys BigBlueButton using Docker Compose. It includes support for Greenlight, OIDC, LDAP, TURN/STUN, health checks, and a modular .env setup. This role is ideal for educational institutions and teams requiring a self-hosted video conferencing solution.

🔧 Note: The database layer should be decoupled in a future release to improve modularity and integration.

Overview

This role provides a fully automated deployment of BigBlueButton using Docker Compose on Arch Linux. It manages the entire lifecycle of the deployment, from cloning the upstream Docker repository and generating the .env configuration to customizing docker-compose.yml for volume usage, WebSocket proxying, and optional LDAP/OIDC integration.

The setup includes conditional Greenlight activation, WebRTC support via TURN/STUN, and various fixes for known container orchestration issues. The role is modular and integrates seamlessly with the Infinito.Nexus infrastructure, including reverse proxy configuration, domain management, and secrets templating.

By default, BigBlueButton is deployed with best-practice hardening, modular secrets, and support for multiple authentication methods and scalable storage backends.

Features

  • 🐳 Docker-based deployment via official bigbluebutton/docker
  • ✅ Greenlight (v3) frontend support
  • 🔐 SSO with OIDC & LDAP (optional)
  • 🧱 Automatic .env templating and domain/Nginx integration
  • 🛠 Volume patching and Docker Compose customization
  • 📬 SMTP integration and Greenlight admin creation
  • 🧪 Workarounds for known Docker Compose or Etherpad issues

Single Sign-On (SSO)

  • Docs: External Authentication
  • Supports:
    • ✅ OpenID Connect (OIDC)
    • ✅ LDAP (with custom DN and filters)
    • 🧩 Custom OAuth2 flows via ENV vars

System Requirements

  • Arch Linux with Docker, Compose, and Nginx roles pre-installed
  • DNS and reverse proxy configuration using sys-svc-proxy
  • Functional email system for Greenlight SMTP

Important Resources