mirror of https://github.com/bigbluebutton/docker.git synced 2024-10-05 09:42:01 +02:00

Docker files for BigBlueButton

Go to file

Sofyan Sugianto 4ade61324b test the bbb-record		2020-06-12 08:16:30 +07: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	test the bbb-record	2020-06-12 08:16:30 +07:00
scripts	coturn integration	2020-06-07 14:52:01 +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	coturn integration	2020-06-07 14:52:01 +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	added missing restart policies	2020-06-06 20:06:28 +02:00
LICENSE	Initial commit	2017-10-27 14:57:35 -04:00
README.md	setup script, readme update and .env rework	2020-06-06 14:41:43 +02:00
sample.env	coturn integration	2020-06-07 14:52:01 +02:00

README.md

BigBlueButton Docker

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.

Open Tasks

add support for recording
add coturn
add prometheus exporter
further separate bbb-core into individual container
enable IPv6 support
switch html5 to node v12
drop root privileges in webrtc-sfu