Ansible role for a bigbluebutton installation (following the documentation on http://docs.bigbluebutton.org/install/install.html)
| Variable Name | Function | Default value | Comment |
|---|---|---|---|
bbb_hostname |
Hostname for this BigBlueButton instance (required) | {{ ansible_fqdn_hostname }} | |
bbb_letsencrypt_enable |
Enable letsencrypt/HTTPS | yes |
|
bbb_letsencrypt_email |
E-mail for use with letsencrypt (required when using LE) | ||
bbb_coturn_enable |
enable installation of the TURN-server | yes |
|
bbb_turn_enable |
enable the use uf TURN in general | yes |
|
bbb_turn_server |
the adress for the TURN-Server to use | {{ bbb_hostname }} |
has to be a fully qualified domain name |
bbb_turn_secret |
Secret for the TURN-Server (required) | can be generated with openssl rand -hex 16 |
|
bbb_greenlight_enable |
enable installation of the greenlight client | yes |
|
bbb_greenlight_secret |
Secret for greenlight (required when using greenlight) | can be generated with openssl rand -hex 64 |
|
bbb_greenlight_db_password |
Password for greenlight's database (required when using greenlight) | can be generated with openssl rand -hex 16 |
|
bbb_disable_recordings |
Disable options in gui to have recordings | no |
Recordings are running constantly in background which is relevant as privacy relevant user data is stored |
bbb_api_demos_enable |
enable installation of the api demos | no |
|
bbb_nodejs_version |
version of nodejs to be installed | 8.x |
|
bbb_system_locale |
the system locale to use | en_US.UTF-8 |
The Web-Frontend has some extra configuration options, listed below:
The notifications are sent using sendmail, unless the bbb_greenlight_smtp.server variable is set.
In that case, make sure the rest of the variables are properly set.
The default value for bbb_greenlight_smtp.sender is bbb@{{ bbb_hostname }}
Example Setup:
bbb_greenlight_smtp:
server: smtp.gmail.com
port: 587
domain: gmail.com
username: youremail@gmail.com
password: yourpassword
auth: plain
starttls_auto: true
sender: youremail@gmail.comYou can enable LDAP authentication by providing values for the variables below. Configuring LDAP authentication will take precedence over all other providers. For information about setting up LDAP, see: https://docs.bigbluebutton.org/greenlight/gl-config.html#ldap-auth
Example Setup:
bbb_greenlight_ldap:
server: ldap.example.com
port: 389
method: plain
uid: uid
base: dc=example,dc=com
bind_dn: cn=admin,dc=example,dc=com
password: password
role_field: ouFor in-depth steps on setting up a Google Login Provider, see: https://docs.bigbluebutton.org/greenlight/gl-config.html#google-oauth2
The bbb_greenlight_google_oauth2.hd variable is used to limit sign-ins to a particular set of Google Apps hosted domains. This can be a string with separating commas such as, 'domain.com, example.com' or a string that specifies a single domain restriction such as, 'domain.com'. If left blank, GreenLight will allow sign-in from all Google Apps hosted domains.
bbb_greenlight_google_oauth2:
id:
secret:
hd:For in-depth steps on setting up a Office 365 Login Provider, see: https://docs.bigbluebutton.org/greenlight/gl-config.html#office365-oauth2
bbb_greenlight_office365:
id:
secret:
hd:By default, the ability for anyone to create a Greenlight account is enabled. To disable this, use false.
For more information see: https://docs.bigbluebutton.org/greenlight/gl-config.html#in-application-greenlight
bbb_greenlight_accounts: 'false'To enable reCaptcha on the user sign up, define these 2 keys. You can obtain these keys by registering your domain using the following url: https://www.google.com/recaptcha/admin
bbb_greenlight_recaptcha:
site_key:
secret_key:This is an example, of how to use this role. Warning: the value of the Variables should be changed!
- hosts: servers
roles:
- { role: n0emis.bigbluebutton, bbb_turn_secret: ee8d093109a9b273, bbb_greenlight_secret: 107308d54ff4a5f, bbb_greenlight_db_password: 2585c27c785e8895ec, bbb_letsencrypt_email: mail@example.com }
MIT