Sunday, November 22, 2026
TR
LinuxOpen Source

Installing BigBlueButton on Ubuntu 18.04

Installing BigBlueButton on Ubuntu 18.04
Contents
  1. Installing Docker 5 for Greenlight
  2. Install Docker 
  3. Installing Greenlight
  4. Configure the BigBlueButton home screen with Greenlight
  5. Installing Docker 5 Compose for Greenlight
  6. Start Greenlight
  7. Creating accounts:

BigBlueButton is a free and open-source web conferencing software developed with a focus on educational institutions. As an HTML5-based web application, BigBlueButton supports all operating systems and platforms.

Features
BigBlueButton supports the LTI 2.0 standard and can be integrated with many different LMS platforms. Aside from the additional features that may come with an LMS and its plugins, BigBlueButton provides its users with the following core features:

  • Creating classes, rooms and groups
  • Teacher/student interaction on a whiteboard
  • User (Teacher/Presenter/Student) permission management
  • Screen sharing management
  • Presenting PDFs on the digital whiteboard
  • Watching educational videos on the digital whiteboard
  • Publishing poll questions

Minimum server requirements:

  • Ubuntu 18.04 64-bit (must run on the 4.x kernel)
  • 8 GB RAM (16 GB RAM recommended)
  • 4 CPU (8 CPU recommended)
  • TCP ports 80 and 443 must be open
  • UDP ports 16384 – 32768 must be open
  • Port 80 must not be used by another application
  • A user with root or sudo privileges on the server
  • SSH access

Other requirements:

  • 100 GB or more of disk space (needed for recordings, SSD recommended)
  • 50-250 Mbits symmetric Internet or more
  • An A DNS record (konferans.kockerim.com ) for the SSL certificate
  • IPV4 and IPV6 addresses

The ports that must be open on the firewall are as follows.

When you update the domain and email address in the command below, it will perform the required installation together with the SSL certificate.

wget -qO- https://ubuntu.bigbluebutton.org/bbb-install.sh | bash -s -- -v bionic-230-dev -s konferans.kockerim.com -e kerim@kockerim.com -a -w

Installing Docker 5 for Greenlight

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add  -
sudo apt-key fingerprint 0EBFCD88

Paste the command below into your SSH window as a whole:

sudo add-apt-repository \
"deb [arch=amd64] https://download.docker.com/linux/ubuntu \
$(lsb_release -cs) \
stable"

Update the packages:

sudo apt-get update

Install Docker 

sudo apt-get install docker-ce docker-ce-cli containerd.io nano -y

Installing Greenlight

Create the required directory and go to it:

mkdir ~/greenlight && cd ~/greenlight

Greenlight will read its environment configuration from the .env file. To create this file and download the Greenlight Docker image, run:

docker run --rm bigbluebutton/greenlight:v2 cat ./sample.env > .env

Next, note down the Greenlight secret key generated by the following command:

docker run --rm bigbluebutton/greenlight:v2 bundle exec rake secret

Sample output:

bbbb88f3dce411e706327abc8df673912fd3ff1decfa4b24c9a349acaff807a6d35a5473aacc0f9a06852275295a105e3d7e8f6496e2378a7709529e1b6ca78e

Open the .env file for editing with the command below:

nano .env

In the editor that opens, paste the secret key you just generated into the SECRET_KEY_BASE field, then save and exit.
It should look like this:

Run the following command and note down the BigBlueButton secret key generated by it:

sudo bbb-conf --secret

Sample output:

URL: https://konferans.kockerim.com/bigbluebutton/
Secret: f1ea9564HdRtUcdjJEiZgCKhGpJnaPqspyTGE3WGN8

Open the .env file for editing with the command below:

nano .env

In the editor that opens, paste the secret key you just generated into the BIGBLUEBUTTON_ENDPOINT and BIGBLUEBUTTON_SECRET fields, then save and exit.

It should look like this:

To check the API, you can edit the address below to match your setup and visit it:

https://mconf.github.io/api-mate/#server=https://konferans.kockerim.com/bigbluebutton/&sharedSecret=f1ea9564HdRtUcdjJEiZgCKhGpJnaPqspyTGE345sd

You should see a screen like this:

Open the .env file for editing with the command below:

nano .env

Find the ENABLE_SSL=true line and enable it by removing the # sign at the beginning.

It should look like this:

Check your configuration:

docker run --rm --env-file .env bigbluebutton/greenlight:v2 bundle exec rake conf:check

The output should be as follows:

Checking environment: Passed
Checking Connection: Passed
Checking Secret: Passed

In other words, it should look like this:

Configure Nginx with Greenlight

docker run --rm bigbluebutton/greenlight:v2 cat ./greenlight.nginx | sudo tee /etc/bigbluebutton/nginx/greenlight.nginx

Restart Nginx:

sudo systemctl restart nginx

Configure the BigBlueButton home screen with Greenlight

sudo nano /etc/nginx/sites-available/bigbluebutton

Add the following just before the final } character at the end of the file:

location = / {
return 307 /b;
}

It should look like this:

Restart Nginx:

sudo systemctl restart nginx

Installing Docker 5 Compose for Greenlight

sudo curl -L "https://github.com/docker/compose/releases/download/1.25.5/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose
sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose

Start Greenlight

cd ~/greenlight
docker-compose --version

It should look like this:

docker run --rm bigbluebutton/greenlight:v2 cat ./docker-compose.yml > docker-compose.yml
export pass=$(openssl rand -hex 8); sed -i 's/POSTGRES_PASSWORD=password/POSTGRES_PASSWORD='$pass'/g' docker-compose.yml;sed -i 's/DB_PASSWORD=password/DB_PASSWORD='$pass'/g' .env
docker-compose up -d

 If you want to restart Greenlight in the future, you can run the following commands in order:

cd ~/greenlight
docker-compose down
docker-compose up -d

Creating accounts:

Regular user:

cd ~/greenlight
docker exec greenlight-v2 bundle exec rake user:create["Muhammed Kerim KOÇ","test@kockerim.com","Kerim123","user"]

User with administrator privileges:

docker exec greenlight-v2 bundle exec rake user:create["Kerim KOÇ","kerim@kockerim.com","Kerim1234","admin"]

Great!  Now go to your domain and log in to BigBlueButton:

If you get an error, do the following.

cd ~/greenlight
Docker pull bigbluebutton/greenlight:v2
docker-compose down
docker-compose up -d
docker run --rm --env-file .env bigbluebutton/greenlight:v2 bundle exec rake conf:check

Kerim Koç

Systems and infrastructure engineer. I write about Linux, open source, high availability and security.