README.md

BigBlueButton 2.2 Docker

Changelog | Issues

About the upcoming BigBlueButton 2.3

the v2.3.x branch became now develop at the official bigbluebutton/docker repository 🎉

• Maintaining both branches is currently requires too much effort for me (@alangecker), why I limit the work now on developing updates for bbb-docker 2.3
• Consider using 2.3.x for new installations, because 2.2.x (this repo) will become obsolete soon without a simple upgrading path.

Features

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

Install

1. Important: I recommend using bbb-docker 2.3.x for new installations, because 2.2.x (this repo) will become obsolete soon without a simple upgrading path.
2. Install docker-ce & docker-compose
   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: https://docs.docker.com/compose/install/
   4. Ensure docker-compose works: $ docker-compose --version
3. Clone this repository

   $ git clone --recurse-submodules https://github.com/alangecker/bigbluebutton-docker.git bbb-docker
   $ cd bbb-docker

4. Run setup:

   $ ./scripts/setup

5. Start containers:

   $ ./scripts/compose up -d

6. If you use greenlight, you can create an admin account with:

   $ ./scripts/compose exec greenlight bundle exec rake admin:create

How-To's

• Upgrade
• Behind NAT
• BBB-Docker Development
• Integration into an existing web server

Special thanks to

• @dkrenn, whos dockerized version (bigbluebutton#8858)(bigbluebutton/bigbluebutton#8858) helped me a lot in understand and some configs.