Docker files for BigBlueButton

Go to file

chandi 8b2eb9a177 ipv6: always serve https		2020-07-30 13:02:00 +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
docs	development instructions	2020-07-22 00:57:51 +02:00
mod	ipv6: always serve https	2020-07-30 13:02:00 +02:00
scripts	ipv6: disable IPv6 if no IP is set	2020-07-30 12:12:36 +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	ipv6: coturn support	2020-07-21 17:23:08 +02:00
docker-compose.demo.yml	added greenlight and api demos	2020-04-12 16:01:57 +02:00
docker-compose.greenlight.yml	devmode: fix wrong redirect by greenlight in non-devmode	2020-07-27 18:45:04 +02:00
docker-compose.https.yml	ipv6: disable IPv6 if no IP is set	2020-07-30 12:12:36 +02:00
docker-compose.prometheus.yml	added prometheus bigbluebutton-exporter	2020-07-24 19:08:17 +02:00
docker-compose.webhooks.yml	add webhooks	2020-07-01 00:45:36 +02:00
docker-compose.yml	add development mode	2020-07-22 00:40:31 +02:00
LICENSE	Initial commit	2017-10-27 14:57:35 -04:00
README.md	ipv6: small variable updates	2020-07-13 17:40:55 +02:00
sample.env	apply v2.2.21 changes	2020-07-30 12:07:03 +02:00

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,...)
Full IPv6 support

Install

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

Clone this repository

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

Run setup:
```
$ ./scripts/setup
```
Start containers:
```
$ ./scripts/compose up -d
```

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

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