bbb
Install BigBlueButton 3.0 (open-source web conferencing) for a domain on Ubuntu 22.04
- Command:
/go/bbb - Category: Installers
- Required option:
-d - Output: Installer output, then the BigBlueButton API URL and secret
- Last updated: 2026-11-20
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:
- enables IPv6
- opens the firewall ports BBB needs, including the WebRTC range
- downloads and runs the official
bbb-install.shinstaller (BBB 3.0, Ubuntu 22.04) - requests an SSL certificate for the domain
- restarts BBB and Nginx
- prints the API URL and secret used to connect a front end such as Moodle or WordPress
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
- Logs the run to
/var/log/go/bbb.log. - Reads
-dand exits if no domain is given. - Enables IPv6 with
enable_ipv6, adds the threenet.ipv6.conf.*.disable_ipv6 = 0lines to/etc/sysctl.conf, and applies them withsysctl -p. - Installs
nanoandgnupg2. - Opens the firewall ports with
ufw(see Ports opened). - Downloads
bbb-install.sh(v3.0.x-release) to the current directory and makes it executable. - Runs the installer for the domain.
- Runs
bbb-conf --restartand restarts Nginx. - Prints the API URL and secret with
bbb-conf --secret.
Known issues
- The script runs
apt -y install updateandapt -y install upgrade. These try to install packages with those names and fail. The commands should beapt updateandapt -y upgrade. The package lists are not refreshed before the installer runs. - Each run appends the three IPv6 lines to
/etc/sysctl.confagain, so running the command twice creates duplicates. - An unknown option prints the usage line but does not stop the command until the domain check.
bbb-install.shis saved in the directory you run the command from and is not removed afterwards.
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 |