docker/README.md

BigBlueButton Docker

Features

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

Install

1. 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
2. Clone this repository

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

3. Run setup:

   $ ./scripts/setup
   

4. Start containers:

   $ ./scripts/compose up -d
   

5. 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
• Integration into an existing Apache setup

Special thanks to

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