Skip to content

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:

  1. Environment Preparation: The system ensures that Docker is installed and running on the host.

  2. Installer Download: The bbb-install.sh script is downloaded from the official repository to /root/bbb-install.sh.

  3. Execution of Installation Script: The installer is executed with specific versioning and configuration flags:

    /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
    
    The -w and -g flags are used to configure the web server and Greenlight components respectively.

  4. 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-v3 container using bundle exec rails runner to 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.in zone.

Application Update Instructions

To update the main BigBlueButton application, you must re-run the installation script with the desired version:

/root/bbb-install.sh -v <version> -s <domain> -e <email_address> -w -g

Location of configuration files and data

  • Installation Script: /root/bbb-install.sh

  • Application Data: Managed within Docker volumes associated with the greenlight-v3 container.

Available ports for connection

  • HTTPS (Web Interface): 443

  • HTTP (Redirects): 80

question_mark
Is there anything I can help you with?
question_mark
AI Assistant ×