• Not well tested, can be still really buggy. Don't use for production!

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. Create .env with $ cp sample.env .env
4. Adjust the values in .env
   • Important: don't forget to change ETHERPAD_API_KEY, SHARED_SECRET and RAILS_SECRET to any random values! For example generated with pwgen 40 3
   • DOMAIN and EXTERNAL_IP are also required
5. Start container. either...
   • Most common setup: BigBlueButton with automatic HTTPS certificate retrieval and Greenlight

     $ docker-compose \
         -f docker-compose.yml \
         -f docker-compose.https.yml \
         -f docker-compose.greenlight.yml \
         up --detach

   • Individual parts:
     • BigBlueButton $ docker-compose up -d
     • HTTPS reverse proxy
       • $ docker-compose -f docker-compose.https.yml up -d
     • API demos
       • $ docker-compose -f docker-compose.demo.yml up -d
       • Access https://bbb.example.com/demo/
     • Greenlight
       • $ docker-compose -f docker-compose.greenlight.yml up -d
       • Create an administrator account
         $ docker exec greenlight-v2 bundle exec rake admin:create
       • Access https://bbb.example.com/b

Kurento binds somehow always to the external IP instead of the local one or 0.0.0.0. For that reason you need to add your external IP to your interface.

$ ip addr add 144.76.97.34/32 dev ens3

Specific to your linux distribution. Use a search engine of your choice. ;)

Also don't forget to forward all necassary ports listed in http://docs.bigbluebutton.org/2.2/configure-firewall.html

cd bbb-docker

# pull repo changes
git pull 

# update bbb-webrtc-sfu
git submodule update --remote 

# rebuild images
docker-compose build --no-cache

# restart services
docker-compose restart

• add support for recording
• add coturn support
• further separate bbb-core into individual container