mirror of https://github.com/bigbluebutton/docker.git synced 2024-11-21 23:53:11 +01:00

Docker files for BigBlueButton

Go to file

chandi 07ce2c483c by default docker should use the prebuilt images. in same cases docker still tries to build it, exceeding the RAM requirement and often failing due to the missing submodules		2023-12-08 12:04:14 +01:00
conf	sip_profiles: add extension field	2020-09-02 12:05:00 +02:00
docs	use local sources instead of pulling inside container	2023-12-07 20:07:01 +01:00
mod	use local sources instead of pulling inside container	2023-12-07 20:07:01 +01:00
repos	BBB 2.7.3	2023-12-07 20:07:01 +01:00
scripts	generate-compose: remove env variables not required in this step	2023-12-07 20:07:01 +01:00
.gitignore	add greenlight-data to .gitignore	2023-03-24 23:07:09 +01:00
.gitmodules	use local sources instead of pulling inside container	2023-12-07 20:07:01 +01:00
CHANGELOG.md	v2.7.3	2023-11-28 15:30:29 +01:00
docker-compose.tmpl.yml	generate-compose: remove env variables not required in this step	2023-12-07 20:07:01 +01:00
LICENSE	Initial commit	2017-10-27 14:57:35 -04:00
README.md	by default docker should use the prebuilt images.	2023-12-08 12:04:14 +01:00
sample.env	Add RESOLVER_ADDRESS env variable for HTTPS_PROXY container.	2023-06-02 09:52:19 +02:00

README.md

📦 BigBlueButton 2.7 Docker

Version: 2.7.3 | Changelog | Issues

Features

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

Requirements

4GB of RAM
Linux (it will not work under WSL)
Root access (bbb-docker uses host networking, so it won't work with Kubernetes, any "CaaS"-Service, etc.)
Public IPv4 (expect issues with a firewall / NAT)

What is not implemented yet

bbb-lti

Install

Install docker-ce & docker-compose-plugin
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 V2: https://docs.docker.com/compose/install/
4. Ensure docker compose works and that you use a version ≥ 1.28 : $ docker compose --version

Clone this repository

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

# use the more stable main branch (sometimes older)
$ git checkout main

Run setup:
```
$ ./scripts/setup
```

(optional) Make additional configuration adjustments

$ nano .env
# always recreate the docker-compose.yml file after making any changes
$ ./scripts/generate-compose

Start containers:
```
$ docker compose up -d --no-build
```

If you use greenlight, you can create an admin account with:

$ docker compose exec greenlight bundle exec rake admin:create