Deployment Overview of BigBlueButton on Server¶
Prerequisites and Basic Requirements¶
To ensure a successful deployment, the following requirements must be met:
-
Operating System: Ubuntu 24.04 (for version
noble-400) or Debian. -
Privileges: Root or sudo access is required to execute installation scripts and manage system services.
-
Domain Name: A valid FQDN configured for the server.
-
Ports: The following ports must be open in the firewall:
-
80/TCP(HTTP) -
443/TCP(HTTPS)
FQDN of the final panel on the hostkey.in domain¶
The application uses a specific subdomain template based on the server ID.
| Parameter | Value |
|---|---|
| Prefix | bbb |
| Domain | hostkey.in |
| Full template | bbb{Server_ID_from_Invapi}.hostkey.in |
Application installation process¶
The application is installed using a dedicated installation script provided by the BigBlueButton developers. The process follows these steps:
-
Environment Preparation: The system ensures that Docker is installed and running on the host.
-
Installer Download: The
bbb-install.shscript is downloaded from the official repository to/root/bbb-install.sh. -
Execution of Installation Script: The installer is executed with specific versioning and configuration flags:
The/root/bbb-install.sh -v noble-400 -s bbb{Server_ID_from_Invapi}.hostkey.in -e info@bbb{Server_ID_from_Invapi}.hostkey.in -w -g-wand-gflags are used to configure the web server and Greenlight components respectively. -
Greenlight Initialization: The system waits for the Greenlight service to become responsive via HTTP before proceeding with administrative setup.
Access Rights and Security¶
-
Firewall: Only necessary web traffic (HTTP/HTTPS) is permitted through the firewall.
-
Administrative User: An administrator account is automatically created within the Greenlight container to allow management of the BigBlueButton instance.
-
SSH Passwords: Sensitive credentials used during the administrative user creation are handled via environment variables and are not stored in plain text in configuration files.
Docker Containers and Their Deployment¶
The deployment utilizes Docker containers for managing the application interface (Greenlight).
| Container Name | Image | Ports | Volumes/Environment | Restart Policy |
|---|---|---|---|---|
greenlight-v3 | Greenlight v3 image | Managed by proxy | Environment variables used for admin creation | Default |
Custom Scripts and Additional Setup¶
The installation process includes several automated actions to finalize the environment:
-
Initial Admin Creation: A script executes within the
greenlight-v3container usingbundle exec rails runnerto create an administrator user with the email[email protected]. This ensures immediate access to the management panel. -
DNS Configuration: The system automatically configures DNS records for the specified prefix on the
hostkey.inzone.
Application Update Instructions¶
To update the main BigBlueButton application, you must re-run the installation script with the desired version:
Location of configuration files and data¶
-
Installation Script:
/root/bbb-install.sh -
Application Data: Managed within Docker volumes associated with the
greenlight-v3container.
Available ports for connection¶
-
HTTPS (Web Interface):
443 -
HTTP (Redirects):
80