thifranc / bbb-docker

Docker files for BigBlueButton

📦 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
      • Debian: https://docs.docker.com/engine/install/debian/
      • CentOS: https://docs.docker.com/engine/install/centos/
      • Fedora: https://docs.docker.com/engine/install/fedora/
      • Ubuntu: https://docs.docker.com/engine/install/ubuntu/
   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

• Upgrading
• Running behind NAT
• BBB-Docker Development
• Integration into an existing web server