/bbb-docker

Docker files for BigBlueButton

Primary LanguageShellGNU Lesser General Public License v3.0LGPL-3.0

bbb-docker-banner

📦 BigBlueButton 2.7 Docker

Version: 2.7.0 | Changelog | Issues

Features

  • Easy installation
  • Greenlight included
  • TURN server included
  • Fully automated HTTPS certificates
  • Full IPv6 support
  • Runs on any major linux distributon (Debian, Ubuntu, CentOS,...)

Requirements

  • 4GB of RAM
  • Linux (it will not work under WSL)
  • Root access (bbb-docker uses host networking, so it won't work with Kubernetes, any "CaaS"-Service, etc.)
  • Public IPv4 (expect issues with a firewall / NAT)

What is not implemented yet

  • bbb-lti

Install

  1. Install docker-ce & docker-compose-plugin
    1. follow instructions
    2. Ensure docker works with $ docker run hello-world
    3. Install docker compose V2: https://docs.docker.com/compose/install/
    4. Ensure docker compose works and that you use a version ≥ 1.28 : $ docker compose --version
  2. Clone this repository 
    $ git clone --recurse-submodules https://github.com/bigbluebutton/docker.git bbb-docker
$ cd bbb-docker

# use the more stable main branch (sometimes older)
$ git checkout main
  3. Run setup: 
    $ ./scripts/setup
  4. (optional) Make additional configuration adjustments 
    $ nano .env
# always recreate the docker-compose.yml file after making any changes
$ ./scripts/generate-compose
  5. Start containers: 
    $ docker compose up -d
  6. If you use greenlight, you can create an admin account with: 
    $ docker compose exec greenlight bundle exec rake admin:create

Further How-To's