BigBlueButton provides a script to install BigBlueButton with single command but it is always better to go through each step, so that you know what is really being done and makes it easy to do any modification or debug any error.
- It is adviced to use a fresh server for the installation of BigBlueButton. The minimum requirement would be a c5.xlarge instance which posses 4 cores and 8GB of RAM.
- A domain to host the bbb server
Ubuntu 16.04 64-bit OS running
Linux kernel 4.x
7443(to configure SSL) and
16384 - 32768open
500GBof free disk space (Recommended for production)
Having enough disk space is essential if you have number of sessions been done since recordings would take up the space. Also consider using a domain and obtain SSL certificate to ensure technologies like WebRTC which is used by BigBlueButton to make real time communication works without any error.
Please go through the below steps to ensure that there are no errors during the installation
- Check that the locale of the server is en_US.UTF-8.
$ cat /etc/default/locale LANG="en_US.UTF-8"
If you don’t see LANG=”en_US.UTF-8”, enter the following commands to set the local to en_US.UTF-8.
$ sudo apt-get install language-pack-en $ sudo update-locale LANG=en_US.UTF-8
Exit from the ssh session and login again before proceding with any other command. Run the first command again to make sure the locale is set correctly.
$ sudo systemctl show-environment LANG=en_US.UTF-8 PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
If you don’t see
$ sudo systemctl set-environment LANG=en_US.UTF-8
and check the output again
Setup Security Groups in EC2
As mentioned above BigBlueButton needs several TCP and UDP ports to be allowed access to.
- Go to
Security Groupsin aws ec2 console
Create Security Group
- Give a name and then press
Custom TCPand enter 80 for
Sourceif you would not mind allowing traffic from any ip.
- Repeat the steps from 2-6 for ports 443, 5066 and 7443
- Also select
Custom UDP,enter 16384 - 32768 and repeat the steps 5-6
Install necessary packages and security updates
$ grep "multiverse" /etc/apt/sources.list
Here an uncommented line should have
multiverseword with it. If not
$ echo "deb http://archive.ubuntu.com/ubuntu/ xenial multiverse" | sudo tee -a /etc/apt/sources.list
$ add-apt-repository ppa:jonathonf/ffmpeg-4 -y $ add-apt-repository ppa:rmescandon/yq -y
to add repositores
ffmpegneeded for bigbluebutton
$ sudo apt-get update $ sudo apt-get dist-upgrade
to update the system with the added repositories
$ sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 0C49F3730359A14518585931BC711F9BA15703C6 $ echo "deb [ arch=amd64,arm64 ] http://repo.mongodb.org/apt/ubuntu xenial/mongodb-org/3.4 multiverse" | sudo tee /etc/apt/ sources.list.d/mongodb-org-3.4.list $ sudo apt-get update $ sudo apt-get install -y mongodb-org curl
to install mongodb which is used by bigbluebutton
$ curl -sL https://deb.nodesource.com/setup_8.x | sudo -E bash - $ sudo apt-get install -y nodejs` to install nodejs
Add Public Key to server’s key chain and get bigbluebutton packages
$ wget https://ubuntu.bigbluebutton.org/repo/bigbluebutton.asc -O- | sudo apt-key add -
to add project’s public key to server key chain
We will be installing bigbluebutton-2.2beta which is the latest at the time of this article. Since your server needs to know where to download the BigBlueButton 2.2-beta packages,
$ echo "deb https://ubuntu.bigbluebutton.org/xenial-220-beta/ bigbluebutton-xenial main" | sudo tee /etc/apt/sources.list.d/bigbluebutton.list $ sudo apt-get update
If you have followed the steps properly you should be ready to install bigbluebutton now.
$ sudo apt-get install bigbluebutton $ sudo apt-get install bbb-html5 $ sudo apt-get dist-upgrade
Next, restart BigBlueButton:
$ sudo bbb-conf --restart
/usr/share/bbb-web/WEB-INF/classes/bigbluebutton.properties and update the following property.
/usr/share/red5/webapps/screenshare/WEB-INF/screenshare.properties and update the following properties.
streamBaseUrl=rtmp://example.site.com/screenshare jnlpUrl=https://example.site.com/screenshare jnlpFile=https://example.site.com/screenshare/screenshare.jnlp
Run the following command to configure the BigBlueButton server with your hostname
$ bbb-conf --setip example.site.com
Install Nginx and SSL certificates
I would recommend to use nginx with bbb. To install nginx
$ sudo apt install nginx
If you have a domain you can get SSL certificates and configure nginx automatically with letsencrypt
$ sudo apt-get update $ sudo apt-get install software-properties-common $ sudo add-apt-repository universe $ sudo add-apt-repository ppa:certbot/certbot $ sudo apt-get update $ sudo apt-get install certbot python-certbot-nginx $ sudo certbot --nginx
Test the installation
https://example.site.com/ and if loads a screen like below the installation is successfull.
If you experience an error when starting the bbb server you can first try uing
$ sudo bbb-conf --check
which will show you a summary of the bbb services and their status. It will also show errors under
** Potential problems described below ** from which you can get a clue of what you are doing wrong.