Skip to content

juanluisbaptiste/ansible-bigbluebutton

master
Switch branches/tags
Code
This branch is 39 commits ahead of softwaremill:master.
Contribute

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 
 
 
 
 

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: foo@bar.com

About

BigBlueButton Ansible role

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Jinja 100.0%