Skip to main content
Version: 2.6

Install Greenlight v3

Overview

Greenlight is an open-source, LGPL-3.0 licensed web application that allows organizations to quickly set up a complete web conferencing platform using their existing BigBlueButton server. It is user-friendly for both regular and advanced users.

Greenlight v3, the latest version, is constructed with the cutting-edge versions of Ruby on Rails and React - a robust technology stack adopted by millions of projects and trusted by major corporations worldwide.

Greenlight v3 is equipped with local authentication by default. This means that authentication is managed internally within the platform and does not require any external servers or services. For those who need additional authentication options, Greenlight v3 can be configured to connect to external authentication servers through OpenID Connect. For more information see External Authentication.

There are 2 ways to install Greenlight v3:

  1. Installing alongside a BigBlueButton Server.
  2. Installing on a Standalone Server.

Installing alongside a BigBlueButton Server

bbb-install Script

If your server already contains a BigBlueButton server that you like to upgrade to v2.6, or you would like to install a new BigBlueButton server on a clean environment along with Greenlight, then please refer to bbb-install script for guides on the bbb-install command and its options.

To install Greenlight, simply run the bbb-install-2.6 script with your chosen configurations, while ensuring to include the -g option to install/upgrade Greenlight alongside of your BigBlueButton server.

Running the Script

To run the script, simply run the command below, replacing [OPTIONS], with the your chosen configurations.

wget -qO- https://ubuntu.bigbluebutton.org/bbb-install-2.6.sh | bash -s -- [OPTIONS] -g

After the script completes, a success message will appear in the console with the URL to access Greenlight confirming that BigBlueButton was installed/upgraded alongside with Greenlight.

Creating an Admin Account

Once installation is complete, you will need to create an Administrator account to access the administrator panel.

You can do that by running the following command:

docker exec -it greenlight-v3 bundle exec rake admin:create['name','email','password']

You can also run it without any arguments to create the default admin account, which you can either change its password and use, or use it to promote your own account becoming an Administrator and then delete it.

docker exec -it greenlight-v3 bundle exec rake admin:create

Installing on a Standalone Server

Greenlight Install Script

If you're installing Greenlight on a standalone server (a server where you don't want to include BigBlueButton), we've created an install script to simplify the steps required to get Greenlight up and running.

The Greenlight Install Script provides you with a variety of options to suit whatever needs you have. Before running the install script, you must choose which options you would like. Here are the current supported options:

-s <hostname>            Configure server with <hostname> (Required)

-b <hostname>:<secret> The BigBlueButton server credentials (bbb-conf --secret) (Required)

-k Install Keycloak - needed for external authentication (Optional)

-d Skip SSL certificates generation (Required, if -e is omitted).
* Certificate files(fullchain.pem, privkey.pem) to be used must be placed in /local/certs/
* Cannot be used when -e is used.

-e <email> Email for Let's Encrypt certbot (Required, if -d is omitted)
* Cannot be used when -d is used.

And environmental variables:

VARIABLES (configure Greenlight):
GL_PATH Configure Greenlight relative URL root path (Optional)
* Use this when deploying Greenlight behind a reverse proxy on a path other than the default '/' e.g. '/gl'.

Sample Configurations

  • Sample options to setup a Greenlight 3.x server with a publicly signed SSL certificate for a FQDN of www.example.com and an email of info@example.com that uses a BigBlueButton server at bbb.example.com with secret SECRET:

    -s www.example.com -e info@example.com -b bbb.example.com:SECRET

  • Sample options to setup a Greenlight 3.x server with pre-owned SSL certificates for a FQDN of www.example.com that uses a BigBlueButton server at bbb.example.com with secret SECRET:

    -s www.example.com -b bbb.example.com:SECRET -d

Running the Script

To run the script, simply run the command below, replacing [OPTIONS], with the values from above.

wget -qO- https://raw.githubusercontent.com/bigbluebutton/greenlight/master/gl-install.sh | bash -s -- [OPTIONS]

After the script finishes running, a success message will appear in the console, confirming that Greenlight v3 is now accessible at the URL specified during installation.

Creating an Admin Account

Once installation is complete, you will need to create an Administrator account to access the administrator panel.

You can do that by running the following command:

docker exec -it greenlight-v3 bundle exec rake admin:create['name','email','password']

You can also run it without any arguments to create the default admin account, which you can either change its password and use, or use it to promote your own account becoming an Administrator and then delete it.

docker exec -it greenlight-v3 bundle exec rake admin:create

Optional .env Configurations

Default Locale Setup

Variable NameDescriptionDefault Value
DEFAULT_LOCALEThe default language for all newly created users. Users will still have the ability to change their language through their profile.en

Email Setup

SMTP configuration requires following the guidelines provided by your SMTP server's documentation. The specific configuration details will vary based on the SMTP server you are using. It is important to refer to the relevant documentation in order to properly set up SMTP for your needs.

Variable NameDescriptionDefault Value
SMTP_SERVERThe address of the remote mailing server having an open SMTP service.-
SMTP_PORTThe port on which the SMTP service is accessible through on the remote SMTP_SERVER. Usually, it’s 25 TCP for SMTP and 465 TCP for SMTPS.-
SMTP_USERNAMEThe username of the account to use when authenticating to the SMTP_SERVER.-
SMTP_PASSWORDThe password of the account to use when authenticating to the SMTP_SERVER.-
SMTP_AUTHThe authentication type to use to authenticate to the SMTP_SERVER: (plain, login, cram_md5).-
SMTP_DOMAINThe domain_name of the SMTP client. Usually, it’s the domain name portion of the SMTP_SENDER_EMAIL FQDN.-
SMTP_SENDER_EMAILThe email sender address that will appear in the FROM section of the emails.-
SMTP_SENDER_NAMEThe email sender name that will appear in the FROM section of the emails.-
SMTP_STARTTLS_AUTOAutomatically chooses between STARTTLS and plain SMTP depending on your SMTP servertrue
SMTP_STARTTLSChecks if the SMTP_SERVER supports STARTTLS protocol command and uses it to negotiate an upgrade to SMTPS over the initiated unencrypted connection.false
SMTP_TLSUse SMTPS when connecting to the SMTP_SERVER.false
SMTP_SSL_VERIFYDefines whether or not to enable SSL verification on the certificate of the SMTP_SERVER when connecting through SMTPS.true

OpenID Connect Setup

Variable NameDescriptionDefault Value
OPENID_CONNECT_CLIENT_IDThe client ID of the OpenID issuer-
OPENID_CONNECT_CLIENT_SECRETThe secret to use to authenticate to the OpenID issuer-
OPENID_CONNECT_ISSUERThe URL for the OpenID issuer. It is required to be HTTPS URL using the default HTTPS port (TCP 443)-
OPENID_CONNECT_REDIRECTThe Redirect URI after successful authentication. It should be the URL to Greenlight-

HCaptcha Setup

Variable NameDescriptionDefault Value
HCAPTCHA_SITE_KEYThe site key that links to your hCaptcha site-
HCAPTCHA_SECRET_KEYThe secret to use to authenticate with hCaptcha-

Relative URL root path (subdirectory) Setup

Greenlight by default will expect being deployed on the root path / of your FQDN (Fully qualified domain name). If having a custom setup and not willing to deploy the application on the root path one could simply run the installation scripts (for more details about the installation options kindly check Overview) with the GL_PATH variable set to their chosen configuration and upgrade Greenlight.

To reflect the relative root path change an upgrade to Greenlight is required.

So, to deploy Greenlight on a relative URL root path of /gl:

For systems using BigBlueButton Install Script one would simply run while ensuring to include the -g option:

wget -qO- https://ubuntu.bigbluebutton.org/bbb-install-2.6.sh | GL_PATH=/gl bash -s -- [options] -g

For systems using Greenlight Install Script one would simply run:

wget -qO- https://raw.githubusercontent.com/bigbluebutton/greenlight/master/gl-install.sh  | GL_PATH=/gl bash -s -- [options]

Notice the omitting of any trailing slashes in GL_PATH.

Alternatively, one could directly update the Greenlight .env file located at /root/greenlight-v3/.env and manually set the RELATIVE_URL_ROOT variable to match their desired setup and simply re-run afterwards the bbb-install command with the -g option included but without defining and using the GL_PATH variable.

  • We recommend the use of the first approach whenever possible.

The GL_PATH variable on the shell session (if defined) will always be prioritized over the RELATIVE_URL_ROOT (even if the latter is set).

Variable NameDescriptionDefault Value
RELATIVE_URL_ROOTThe relative URL root path that Greenlight will be deployed on. This can be used to inform Greenlight to expect traffic relative to a certain path, admins can use this to have a custom deployment of the application meeting their requirements./