GoAdmio

bbb

Install BigBlueButton 3.0 (open-source web conferencing) for a domain on Ubuntu 22.04

On this page: Overview · Quick start · Syntax · Options · Output · Examples · Troubleshooting · Details · See also


Overview

/go/bbb installs BigBlueButton (BBB), an open-source web conferencing system, on the server for one domain. It:


Quick start

# Install BigBlueButton for bbb.example.com
/go/bbb -d bbb.example.com

Point the domain's A record to this server before you run the command.


Syntax

/go/bbb -d <domain>

Options

Option Required Default Notes
-d <domain> Yes — The domain BBB will be served from. Also used for the SSL certificate and the contact email info@<domain>.

Without -d, the command prints Usage: bbb [-d] Domain and exits with status 1.


Output

The command shows the output of each step. When it finishes, bbb-conf --secret prints the details you need to connect BBB to another application:

URL: https://bbb.example.com/bigbluebutton/
Secret: <secret>

The exact layout comes from bbb-conf. Keep the secret private.

Each run also adds a line to /var/log/go/bbb.log.


Examples

# Install BBB on a subdomain
/go/bbb -d bbb.example.com
# Show the API URL and secret again later
bbb-conf --secret

Troubleshooting

Symptom Likely cause Fix
Usage: bbb [-d] Domain -d is missing or the option is not recognized. Pass the domain: /go/bbb -d bbb.example.com.
SSL certificate request fails The domain does not point to this server, or port 80 is blocked. Point the A record to this server, then run again.
bbb-install.sh stops with an OS error BBB 3.0 needs Ubuntu 22.04 (jammy). Use a server running Ubuntu 22.04.
Ports 80 or 443 already in use Another web server or site is using them. Install BBB on a dedicated server.
Participants cannot hear or see each other WebRTC ports are blocked by a provider firewall. Open 16384:32768/udp, 3478, and 1935 in your provider's firewall too.
E: Unable to locate package update See Known issues. The step fails but the install continues.

Details

Ports opened

Port Protocol Purpose
80 TCP HTTP and certificate validation
443 TCP HTTPS
1935 TCP RTMP
3478 TCP/UDP TURN/STUN
16384:32768 UDP WebRTC media

Installer options

The BBB installer is run as:

bash bbb-install.sh -v jammy-300 -s <domain> -e info@<domain>
Flag Meaning
-v jammy-300 Install BBB 3.0 on Ubuntu 22.04
-s <domain> Hostname of the server
-e info@<domain> Email used for the Let's Encrypt certificate

Greenlight (the BBB front end) is not installed. Connect BBB to your own application with the URL and secret.

What it does, in order

  1. Logs the run to /var/log/go/bbb.log.
  2. Reads -d and exits if no domain is given.
  3. Enables IPv6 with enable_ipv6, adds the three net.ipv6.conf.*.disable_ipv6 = 0 lines to /etc/sysctl.conf, and applies them with sysctl -p.
  4. Installs nano and gnupg2.
  5. Opens the firewall ports with ufw (see Ports opened).
  6. Downloads bbb-install.sh (v3.0.x-release) to the current directory and makes it executable.
  7. Runs the installer for the domain.
  8. Runs bbb-conf --restart and restarts Nginx.
  9. Prints the API URL and secret with bbb-conf --secret.

Known issues


See also

Command Description
ipv6 Enable, disable, or configure IPv6 on the server
allow Open a port in your server's firewall
firewall Install a firewall on a GoAdmio server
installssl Install Let's Encrypt SSL on GoAdmio
nginx Convert a GoAdmio server from Apache to Nginx