Docker files for BigBlueButton
Go to file
2020-07-12 19:15:40 +02:00
bbb-webrtc-sfu@400fe636e6 changes for v2.2.7 2020-04-29 16:35:03 +02:00
conf gitignore and instructions for default presentation 2020-05-22 15:46:35 +02:00
mod initial IPv6 support 2020-07-12 19:15:40 +02:00
scripts initial IPv6 support 2020-07-12 19:15:40 +02:00
.gitignore postgres data persistance 2020-05-17 11:06:28 +02:00
.gitmodules add bbb-webrtc-sfu as git submodule 2020-04-11 19:39:55 +02:00
docker-compose.coturn.yml initial IPv6 support 2020-07-12 19:15:40 +02:00
docker-compose.demo.yml added greenlight and api demos 2020-04-12 16:01:57 +02:00
docker-compose.greenlight.yml added missing restart policies 2020-06-06 20:06:28 +02:00
docker-compose.https.yml coturn integration 2020-06-07 14:52:01 +02:00
docker-compose.yml initial IPv6 support 2020-07-12 19:15:40 +02:00
LICENSE Initial commit 2017-10-27 14:57:35 -04:00
README.md Move tasks to github issues 2020-06-30 22:32:08 +02:00
sample.env initial IPv6 support 2020-07-12 19:15:40 +02:00

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
    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
    

Note if you use a Firewall / NAT

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.

Temporary way (until next reboot)
$ ip addr add 144.76.97.34/32 dev ens3
Permanent way

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

Ports

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

Upgrading

cd bbb-docker

# if you use greenlight:
# create a database backup
docker exec -t docker_postgres_1 pg_dumpall -c -U postgres > /root/greenlight_`date +%d-%m-%Y"_"%H_%M_%S`.sql

# upgrade!
./scripts/upgrade

# restart updated services
./scripts/compose up -d

If you're on an old version, you might get following error:
no such file or directory: ./scripts/upgrade
A simple $ git pull resolves that, by fetching a newer version which includes the upgrade script.

Special thanks to