Installing on a bigbluebutton server

BigBluebutton Microphone not working

If you are a student, trying to join a BIgBlueButton online class (assuming you are using a Chrome browser):

  1. Your Chrome browser would prompt you to give access to the microphone. Click on “Allow”.
  2. If you have “Blocked” microphone access earlier, follow the steps below to give access to the microphone:
    1. Open Chrome Chrome.
    2. At the top right, click More More and then Settings.
    3. Under “Privacy and security,” click Site settings.
    4. Click Camera or Microphone.
    5. Turn on or off Ask before accessing.
    6. Review your blocked and allowed sites.
    7. To allow a site that you already blocked: Under “Blocked,” select the site’s name and change the camera or microphone permission to “Allow.”
  3. Ensure that you have the latest version of Chrome browser

For other browsers such as Firefox or Safari, you would need to follow a similar process.If you are a BigBlueButton server administrator and some of your users are complaining for not able to use microphone:

Особенности и утилиты

BigBlueButton обладает множеством функций, которые идеально подходят для онлайн-семинаров по обучению. Во время сеансов вы можете обмениваться аудио, видео, презентациями и своим рабочим столом, а также сотрудничать со студентами, используя доску, общие заметки, опросы и чат.

BigBlueButton идет дальше, чем традиционное программное обеспечение для видеоконференций, в своих функциях, полезных для виртуального класса. Например, у вас есть многопользовательская доска и вы можете разместить студентов в комнатах обсуждения групп, чтобы вместе решать проблемы.

Что важно для учебных заведений, BigBlueButton легко интегрируется с основными системами управления обучением, такими как Moodle, Canvas и Jenzabar.

BigBlueButton имеет функции видеоконференций, специально разработанные для виртуального класса. (Изображение предоставлено: BigBlueButton)

Настройка TURN сервера

Настройте TURN сервер согласно руководству.

Укажите BigBlueButton использовать настроенный TURN сервер в качестве STUN и TURN серверов. Для подключения к TURN серверу используется ключ 4b85833c7fdf06130bd7398ac9af558b, указанный в параметре , настройки TURN сервера.


<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns=""

    <bean id="stun0" class="">
        <constructor-arg index="0" value=""/>

    <bean id="turn0" class="">
        <constructor-arg index="0" value="4b85833c7fdf06130bd7398ac9af558b"/>
        <constructor-arg index="1" value=""/>
        <constructor-arg index="2" value="86400"/>

    <bean id="turn1" class="">
        <constructor-arg index="0" value="4b85833c7fdf06130bd7398ac9af558b"/>
        <constructor-arg index="1" value=""/>
        <constructor-arg index="2" value="86400"/>

    <bean id="stunTurnService"
        <property name="stunServers">
                <ref bean="stun0"/>
        <property name="turnServers">
                <ref bean="turn0"/>
                <ref bean="turn1"/>

Перезапустите BigBlueButton:

bbb-conf —restart

How to record a session

Whether to record a session in BigBlueButton is handled by 3rd party software.

  1. If you are using BigBlueButton API: When you create a BigBlueButton session you pass ‘record=true’ as a parameter in the “create” API call, which will enable recording of the meeting session.
  2. If you are using BigBlueButton with Moodle: When setting up the BigBlueButtonBN activity, ensure the Session can be recorded is checked on the activity settings and the Instance type is Room/Activity with recordings.
  3. If you are using BigBlueButton with Canvas: Select “Enable recording for this conference” while creating a Conference in Canvas.

 The record button will then be available when the BigBlueButton session is started.  Remember you need to click this button to record the session.

What is system requirement for users to attend BigBlueButton meetings

For users to join a BigBlueButton meeting with reliable audio and video, they should have a dual-core CPU with at least 2GB of memory.

Users can use any laptop or desktop running Apple macOS, Microsoft Windows or Linux or mobile phone – Apple iOS or Google Android.

Users should use the latest version of Chrome or Firefox to join the meeting. Other browsers – Safari and Edge (running latest Chromium) also works fine.

However, in case your users face any difficulties with audio or video (such as audio is garbled or they are periodically getting disconnected), please recommend them to use Chrome or Firefox, which will deliver better audio in lower bandwidth conditions.

Automatic installation of BigBlueButton

For a quick basic installation of BigBlueButton the project offers an installation script, which installs and configures all necessary components on a clean Ubuntu 16.04 system (64bit). It is recommended to choose a Ubuntu minimal installation, because the system should not have any applications like apache, plesk, etc. installed.

Again, the project has created a very detailed installation guide which is maintained together with the installation script on Github.

The script allows the installation of BigBlueButton on the Ubuntu system with a single command. Before doing so, you have to log in as user root on the system or become user root via the command .

Before the actual installation, you should carry out some checks on the system, which are described in the section .

If the check was successful, the installation can be started with the following command:

The command downloads the installation script directly from the project’s server and starts it immediately with all necessary parameters. Among them is

  • : the BigBlueButton version to be installed
  • : the public FQDN of the system for which a Let’s-Encrypt certificate is obtained
  • : the contact e-mail address needed to request a Let’s-Encrypt certificate
  • : the FQDN of the TURN server as well as the necessary password

After the installation is completed via the script, which takes about 15 minutes, the BigBlueButton server can theoretically be used immediately. The frontend Greenlight, which is included in the standard installation, is ready for use and can be reached at in the above example. If the configuration has not yet been adjusted, any user can currently register with the instance, log in and set up their own conference rooms.

Requirements for the installation

As already mentioned, the number of possible participants is strongly dependent on the resources of the system. Therefore, the BigBlueButton project recommends the following minimum requirements for setting up your own server:

  • 8 GB RAM
  • 4 CPU cores
  • 500GB free space in file system for conference recordings
  • Network connection with 250 MBit/s bandwidth (symmetrical)

If the system is protected by a firewall, the following ports of the BigBlueButton system must be accessible from outside:

  • TCP ports 22, 80 and 443
  • UDP ports 16384 to 32768

Furthermore, the BigBlueButton system must be able to access port 7636 of the UCS LDAP server to be used later.

In order to make the BigBlueButton system easily accessible for all participants and to obtain a Let’s-Encrypt certificate for the system automatically during this sample installation, a DNS-A record for the public IP address of the server system must be set up before installation. In these installation instructions, the FQDN is used as an example.

As operating system BigBlueButton version 2.2 requires Ubuntu 16.04.

Видеозапись конференции

Поделиться видеозаписью

Запись появляется в списке доступных в течение 1 дня. После чего можно поделиться ссылкой на запись.
Для этого необходимо сделать запись публичной, нажать правой кнопкой мыши на кнопку «Презентация» и скопировать адрес ссылки, после чего скопированная ссылка может быть вставлена, например, в текст письма электронной почты и отправлена всем желающим. Все публичные записи комнаты будут так же доступны для просмотра всем участникам мероприятия по пригласительной ссылке на странице входа в видеоконференцию.

Скачать видеозапись

Для того чтобы сохранить запись мероприятия в виде файла на жесткий диск компьютера, необходимо открыть запись мероприятия, нажать правой кнопкой мыши на фрагмент изображения где отображается запись с веб-камер и выбрать в появившемся меню «Сохранить видео как…». При этом в файле будут сохранены только видео и звук с веб-камер и микрофонов участников. Сохранение записи мероприятия в том виде, в котором оно отображается для просмотра в браузере (с синхронным отображением презентаций и прочего медиаконтента) не поддерживается.

Отказ от записи мероприятия

По умолчанию ведется запись всех мероприятий. Если записывать мероприятие не требуется, необходимо остановить запись. Для этого надо нажать на кнопку в форме синего овала с красной точкой в котором отображается время записи и в появившемся окне подтвердить остановку записи.

Присоединиться к конференции в качестве слушателя

Для того чтобы присоединиться к мероприятию в качестве слушателя необходимо ввести пригласительную ссылку в адресной строке браузера, после чего отобразится страница входа в видеоконференцию. Ссылку отправляет модератор (организатор). Перед входом в видеоконференцию, потребуется ввести имя для того чтобы модератор комнаты и другие участники видеоконференции могли определить участника. После ввода имени можно будет присоединиться к видеоконференции, нажав на кнопку «Присоединиться», находящуюся правее поля для ввода имени.

После нажатия на кнопку «Присоединиться» откроется главная страница видеоконференции.

General troubleshooting

Check whether the following ports are open at UFW firewall on your BBB server:

  • TCP: 22, 80, 443, 7443
  • UDP: 16384:32768

If your BBB server behind NAT then first un-comment the line externalAddress= in in the /etc/kurento/modules/kurento/WebRtcEndpoint.conf.ini file and replace the IP with your external IP address. Then restart bbb-conf –restart

In case you face error 1020 on Safari, please be aware that IPv6 can be disabled on your BBB host and it will still function for iOS devices.

Execute bbb-conf –check and check for the output. Change wss-binding: to wss-binding: EXTERNAL_IP:7443 Change ext-rtp-ip: $${local_ip_v4} to ext-rtp-ip: $${external_rtp_ip} Change ext-sip-ip: $${local_ip_v4} to ext-sip-ip: $${external_sip_ip}

In case you face error 1020 on Safari or your BBB server is behind NAT, check to see if you are getting Stun service. Note down Stun server IP and Port from the file /etc/kurento/modules/kurento/WebRtcEndpoint.conf.ini Install Stun client: sudo apt install stun-client Execute: sudo stun stunAddressAsInKurento:stunPortAsInKurento -v If you receive code 0x0001c means Stun service is not working.

You may consider installing your own Turn server.

Upgrade your kernel to 4.4.0-187.217 Execute to verify: uname -r

Check that your server has (at least) 4 CPU cores. Execute to verify: cat /proc/cpuinfo | awk ‘/^processor/{print $3}’ | wc -l

. Otherwise, you may face errors such as blank screen on join meeting or not able to use a webcam.

Are you still using Flash client? Click here to make .

If you upgraded BigBlueButton to the latest version and are facing issues in joining the meeting, do a bbb-conf –setip

If you are using Greenlight and face a 404 error page after rebooting, the container is probably not running. Do as follows: $ cd greenlight $ docker-compose down $ docker-compose up -d

Sometimes when you reboot, your server IP address may change and you may face 404 error. To resolve this issue, execute the following commands: $ sudo bbb-conf –setip $ sudo bbb-conf –clean $ sudo bbb-conf –check Also, you should consider using a hostname (not IP address) for your BigBlueButton server. That way, you can also use Let’s Encrypt (via to get a SSL certificate.

If you find that Libreoffice temp files are filling the disk space, you can delete these files using a cron job that runs a command such as find /tmp/*.tmp -mtime +5 -exec rm {} \;

Please ensure that you are running the latest version of BigBlueButton as that would have many bugs and security fixes. Any problem you might be facing in older versions might have been already addressed.

Is it OK to modify BigBlueButton

Yes, you can customize and modify BigBlueButton to meet your requirements.

Here is the detailed guideline on customizing the default installation of BigBlueButton. Some of the available customizations are as follows:

  1. Manage recordings: delete recordings older than N days, move recording to a different partition and migrate recordings from a previous version.
  2. Reduce bandwidth from webcams
  3. Disable webcams or screen sharing to save bandwidth
  4. Add a phone number to the conference bridge, so that your students can join the class by using a telephone number.
  5. Pass custom parameters to the client. This helps you in, for example, minimizing the presentation area or hiding the chat panel when a student joins a class.

Here is a document that gives you an overview of how to set up a development environment for BigBlueButton and make changes into the code or build new features, as you see fit.

Quoting Fred Dixon, CEO of Blindside Network, on modifying BigBlueButton:

How to install BigBlueButton

Setting-up BigBlueButton requires some technical knowledge. Otherwise, it’s a straightforward 15 minute operation.

Following is a quick overview of installing a BigBlueButton server:

  1. Ensure
  2. Pre-install check: Ensure that you have right version of Ubuntu, server supports IPv6 and and the server has minimum 4 core
  3. Have a hostname (example – and SSL certificate. You can use a free SSL certificate from Let’s Encrypt.
  4. Configure your firewall. You may use UFW on Ubuntu.
  5. Update your server
  6. Install apt-get key for BigBlueButton repository.
  7. Install BigBlueButton
  8. Estimated time of installation: 15 minute.


BigBlueButton предлагает определенные основные функции, в том числе:

  • обмен аудио, видео, экраном в реальном времени
  • публичный / приватный чат
  • Выгрузка офисных документов в формате PDF и Microsoft
  • Интерактивная доска
  • Интеграция с телефонными системами (с помощью FreeSWITCH )

Определенные варианты использования предназначены для учителей, использующих программное обеспечение, в том числе:

  • Репетиторство / часы виртуального офиса
  • Перевернутый класс
  • Групповое сотрудничество
  • Полные онлайн-классы

BigBlueButton — это чистый клиент HTML5; для его использования не требуется никаких приложений. Он использует поддержку браузера для веб-коммуникаций в реальном времени WebRTC для отправки / получения аудио, видео и экрана.

Video-conferencing despite symmetric NAT: Installation of a TURN server

Before we start with the installation, we need to take a look at one more component, because even with a conference server that has a public IP address, users may experience connection problems with the BigBlueButton server.
This is because the Internet provider or the user’s router often uses a firewall or different types of NAT. These mechanisms can interfere with the audio and video streams of conference systems like BigBlueButton. To enable these users to participate in BigBlueButton conferences, a so-called TURN server can be set up (TURN stands for “Traversal Using Relays around NAT”). The TURN server acts as a relay and receives the data streams for audio and video from the BigBlueButton server and forwards them to the participant (and vice versa). The TURN server uses various tricks to pass NAT and firewall.

For the BigBlueButton installation path we have chosen here, the TURN server must be installed on an independent system or virtual machine with its own public IP address and public DNS entry. However, there are no special demands on CPU or memory resources for the operation of the TURN server. In many cases a 1-core system with 2GB RAM is sufficient. Nevertheless, the network connection of the TURN server should correspond to that of the BigBlueButton system, because in extreme cases the entire data traffic between the BigBlueButton system and the conference participant systems is routed through the TURN server.

The BigBlueButton project has already described in detail how to set up its own TURN server in its .

If a TURN server is already available, it can of course be used. Later, when installing BigBlueButton, the FQDN of the TURN server (here in our example ) and the password for accessing the TURN server will be required.

How to watch a recorded session in BigBlueButton

You can watch your BigBlueButton recorded session at the following url:



  • BBB_HOST: The domain or IP of your BigBlueButton server
  • MEETING_ID: Internal meeting id assigned by BigBlueButton. If you know the external meeting id, which is assigned by your UI – Class++, Moodle, Canvas or your custom UI to access BigBlueButton – you can find the internal meeting id by executing this command: $sudo bbb-record –tointernal “EXTERNAL_MEETING_ID”

To watch a recording, the meeting has to be recorded when it is live. to check how to record a meeting.

You can open the link above in Google Chrome or Mozilla Firefox browser to watch a recorded session. On your browser, individual components – video, chat and presentation – are played using HTML, Javascript and CSS libraries.

Please be aware that, with the default BigBlueButton installation, there is no single file (webm or mp4) that you can download.


BigBlueButton имеет несколько механизмов безопасности для обеспечения безопасности потоков.

Если BigBlueButton установлен на сервере с сертификатом TLS, он шифрует весь контент, отправляемый с сервера в веб-браузер. Для совместного использования аудио, видео и экрана библиотеки WebRTC передают пакеты протокола реального времени (RTP) по протоколу пользовательских дейтаграмм (UDP) через протокол защиты транспортного уровня дейтаграмм (DTLS), а медиапакеты шифруются с использованием безопасного протокола реального времени (см. SRTP). ). Все это обеспечивает высокий уровень встроенной безопасности ваших потоков..

Вы также можете установить код доступа в комнату для каждой сессии и требовать одобрения модератора новых студентов.

Вы можете установить код доступа к комнате на видео конференции. (Изображение предоставлено: BigBlueButton)

What is signed certificate from CA

You would need a SSL certificate on your BigBlueButton server.

All browsers require that the page (i.e. HTML5 client of BigBlueButton) has to be loaded via HTTPS before it is allowed to request access to microphone, webcams or screen.

Without a valid SSL certificate on the server, your BigBlueServer won’t work for audio or video conferencing.

A CA signed certificate, or SSL certificate, is a certificate that has been issued and signed by a publicly trusted certificate authority (CA). You can purchase SSL certificates from many companies selling domain names such as Comodo, GoDaddy, GlobalSign, and DigiCert.

Alternatively, you can use Let’s Encrypt to obtain a free renewable SSL certificate (expires after 90 days, but are automatically renewable).

Facing 1020 media could not reach the server error

If your BigBlueButton server is behind a Firewall or a NAT, Make sure you follow steps below:

Try adding a public stun server, in /etc/kurento/modules/kurento/WebRtcEndpoint.conf.ini


You may for the list of public stun servers (some may be offline so please check if the server you are going to use is available) or use Google’s (, port 19302) or try this (, port 3478).

Still better, you may set up a turn server as detailed here and check if it’s working by clicking here.

Increase your media negotiation timeouts. Recommend setting is to set baseTimeout to 30000 in /usr/share/meteor/bundle/programs/server/assets/app/config/settings.yml

. Needs 2.2.22 or later.

. Needs 2.2.23 or later.

Загрузка и показ презентаций

Для загрузки презентации необходимо нажать на кнопку с изображением синего круга с плюсом «+». Откроется меню, где необходимо выбрать «Загрузить презентацию». Для лучшего результата рекомендуется загружать файлы в формате PDF.

Далее необходимо выбрать презентацию на компьютере и нажать «Загрузить». Можно выбрать для загрузки сразу несколько презентаций, при этом после завершения загрузки в рабочей области будет показана презентация, для которой установлен круглый флажок зеленого цвета с правой стороны.

В дальнейшем в ходе мероприятия для показа нужной презентации достаточно вновь зайти в меню загрузки, выбрать ранее загруженную презентацию, отметив её круглым флажком зеленого цвета с правой стороны, и нажать на кнопку «Подтвердить».

После чего выбранная презентация появится в рабочей области экрана.

Required resources for up to 100 participants

Depending on the hardware configuration, a single BigBlueButton system can serve up to 100 participants, which can be distributed over a single or multiple conferences. The maximum size of a single conference depends on many factors, such as number of participants, number of active webcams, quality of the video streams, hardware equipment of server and participants or even the network connection of the server, so that no general statements can be made here. The project has compiled some key points:

I therefore recommend setting up a test environment for a practice-oriented test.

If it should become bigger – The BigBlueButton cluster

For larger environments, such as universities or school boards, a single BigBlueButton system is not sufficient. With the help of the open source load balancer Scalelite, which was developed especially for BigBlueButton , several BigBlueButton systems can be combined into a cluster on which the individual conferences are distributed.

What is BigBlueButton?

BigBlueButton is an open source project that focuses specifically on the needs of online teaching. The project aims to make participation in video conferences easily accessible. All that is usually required on the participant side is an end device with an up-to-date browser.

The project was founded in 2007 at Carleton University. Since then, it has been continuously developed. During the development, the stability of the software was a priority.
The last major release was in March 2020, when the client-side part of the application was completely renewed, so that now, thanks to HTML5, only end devices with an up-to-date browser are required to participate in conferences. In times of corona, the demand for BigBlueButton has been growing rapidly and so every few days smaller updates were released for BigBlueButton , which improve and extend BigBlueButton.

What if my BigBlueButton is not working

If you follow the instructions to , your installation should be completed without any hassles.

In case you face difficulties, refer to our extensive to help you resolve common issues.

There is a very active open source community, with over 2,500 members, supporting BigBlueButton, whom you can reach-out to in case you are not able to resolve your issues from the troubleshooting guide above.

  1. BigBlueButton-Dev: The mailing list is for developers of BigBlueButton. Topics include making changes to BigBlueButton source, understanding BigBlueButton’s architecture, and feature requests.
  2. BigBlueButton-Setup: This group is for administrators of a BigBlueButton server. Topics include installation and configuration of BigBlueButton, providing access behind a firewall, and setting up 3rd party integrations with BigBlueButton (such as WordPress and Moodle).
  3. Bigbluebutton-Users: This mailing list is for end-user questions on BigBlueButton. Sample topics include questions such as “How do I do X in BigBlueButton?”

While requesting help from the community, please provide as much relevant information as appropriate including your server configuration, whether using firewall, any error message during installation, screenshot of the issue you are facing if applicable, and output of the command “bbb-conf –check”.

How to do small groups

BigBlueButton allows you to create small groups of students for discussion, group work and closer collaboration.

As a moderator, you can create and manage breakout rooms during a live BigBlueButton session and assign students to the different rooms.

As shown in the screenshot, click on the setting icon and select “Create breakout rooms”. Then follow the instructions online.

You can create breakout rooms for a specific duration and assign individual students to different break-out rooms.

At the end of the duration, or when you end breakout rooms, all students will come back to the main room.

Подготовка LXC контейнера

BigBlueButton разрабатывается и тестируется под Ubuntu Xenial. Установить Ubuntu вы можете в LXC-контейнере, для этого выполните установку необходимых пакетов:

emerge -a app-emulation/lxc dev-libs/libcgroup

Запустите сервис cgconfig для создание cgroup systemd:

/etc/init.d/cgconfig start

Настройка запуска Docker внутри LXC контейнера

При использовании Docker внутри LXC контейнера в хостовой системе загрузите необходимые модули ядра и добавьте их в автозагрузку:

modprobe -a br_netfilter ip_tables nf_conntrack_netlink nf_nat overlay xt_conntrack

echo -e «br_netfilter\nip_tables\nnf_conntrack_netlink\nnf_nat\noverlay\nxt_conntrack» > /etc/modules-load.d/docker.conf

Создайте контейнер для BigBlueButton:

lxc-create -t download -n bigbluebutton — -d ubuntu -r xenial -a amd64

Запустите созданный контейнер:

lxc-start bigbluebutton

Настройте сеть согласно , но не присваивайте IP адрес и шлюз через конфигурационный файл контейнера.

Добавьте разрешение, чтобы запустить тест для Docker:


lxc.cgroup.devices.allow = c 10:200 rwm

Настройте параметры сети внутри контейнера, указав необходимый IP адрес, маску сети, шлюз по умолчанию и DNS сервер:


auto eth0
iface eth0 inet static

Перезапустите контейнер:

lxc-stop -r bigbluebutton

Подключитесь к контейнеру:

lxc-attach bigbluebutton

Обновите репозиторий бинарных пакетов:

apt-get update

Установите SSH клиент и сервер:

apt-get install ssh openssh-server -y

Измените пароль пользователя :


Разрешите подключаться через SSH пользователю :


PermitRootLogin yes

Перезапустите сервис SSH:

systemctl restart ssh

Перенастройте локаль:

sed -i -e ‘s/# en_US.UTF-8 UTF-8/en_US.UTF-8 UTF-8/’ /etc/locale.gen

sed -i -e ‘s/# ru_RU.UTF-8 UTF-8/ru_RU.UTF-8 UTF-8/’ /etc/locale.gen

dpkg-reconfigure —frontend=noninteractive locales

update-locale LANG=en_US.UTF-8

Убедитесь, что локаль указана в переменных окружения:

systemctl show-environment


Добавьте определение сервера как

/etc/hosts bigbluebutton localhost

Так как установка производится в контейнере, то для некоторых компонентов BigBlueButton необходим источник энтропии. Установите генератор энтропии:

apt-get install haveged -y

Добавьте демон энтропии в автозагрузку и запустите его:

systemctl enable haveged

systemctl start haveged

Установите утилиты для управления репозиториями:

apt-get install software-properties-common -y