juanluisbaptiste / ansible-bigbluebutton

BigBlueButton Ansible role

Ansible BigBlueButton Installation Role

Ansible role to install BigBlueButton web conferencing platform with SSL support out of the box using LetsEncrypt.

The role follows BigBlueButton official installation instructions.

Forked from softwaremill/ansible-bigbluebutton, as it seems abandoned. Itr has the following additional features:

Features

• Installs latest stable version (currently 2.3).
• Installation behind a firewall (NAT setup support)
• Automatic SSL configuration using LetsEncrypt certificates using thefinn93/ansible-letsencrypt role.
• Optionally installs the demo and check packages.

Supported Platforms

As this role follows the official installation instructions, the supported OS version is the one specified there: Ubuntu (16.04 for the current bbb version).

Requires Ansible >= 2.4.0

Usage

To get up BigBlueButton up and running the following variables can be configured:

• bbb_server_name: Set the FQDN hostname that points to the server where BigBlueButton is going to be installed. This is the only mandatory value, the playbook will fail if this variable is not defined.
• bbb_configure_nat: Configure NAT support for servers behind a firewall (Default: False).
• bbb_configure_ssl: Configure SSL support using LetsEncrypt certificates (Default: False).
• bbb_ssl_email: Set LetsEncrypt authorization email address.
• bbb_install_html5: Install the HTML5 client (Default: True).
• bbb_install_demo: Install the bbb-demo package, useful to easily test the new installation is working (Default: False).
• bbb_install_check: Install the bbb-check package, useful to debug the new installation if having issues (Default: False).
• bbb_install_playback_notes: Install the bbb-playback-notes package to play back shared notes from a recorded session (Default: True).
• bbb_install_playback_podcast: Install the bbb-playback-podcast package to play back audio from a recorded session (Default: True).
• bbb_install_playback_screenshare: Install the bbb-playback-screenshare package to play back shared screens from a recorded session (Default: True).

Example Playbook

---
- hosts: bbb
  remote_user: ansible
  become: True
  become_user: root
  become_method: sudo
  gather_facts: True
  roles:
    - role: ansible-bigbluebutton
      bbb_server_name: bbb.example.com
      bbb_configure_nat: True
      bbb_install_demo: True
      bbb_install_check: True
      bbb_configure_ssl: True
      bbb_ssl_email: [e-mail]