mirror of
https://github.com/bigbluebutton/docker.git
synced 2024-11-22 08:03:19 +01:00
07ce2c483c
in same cases docker still tries to build it, exceeding the RAM requirement and often failing due to the missing submodules
68 lines
2.2 KiB
Markdown
68 lines
2.2 KiB
Markdown
<img width="1012" alt="bbb-docker-banner" src="https://user-images.githubusercontent.com/1273169/141153216-0386cd4e-0aaf-473a-8f42-a048e52ed0d7.png">
|
|
|
|
|
|
# 📦 BigBlueButton 2.7 Docker
|
|
|
|
Version: 2.7.3 | [Changelog](CHANGELOG.md) | [Issues](https://github.com/bigbluebutton/docker/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
|
|
1. 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`
|
|
2. Clone this repository
|
|
```sh
|
|
$ git clone https://github.com/bigbluebutton/docker.git bbb-docker
|
|
$ cd bbb-docker
|
|
|
|
# use the more stable main branch (sometimes older)
|
|
$ git checkout main
|
|
```
|
|
3. Run setup:
|
|
```bash
|
|
$ ./scripts/setup
|
|
```
|
|
4. (optional) Make additional configuration adjustments
|
|
```bash
|
|
$ nano .env
|
|
# always recreate the docker-compose.yml file after making any changes
|
|
$ ./scripts/generate-compose
|
|
```
|
|
5. Start containers:
|
|
```bash
|
|
$ docker compose up -d --no-build
|
|
```
|
|
6. If you use greenlight, you can create an admin account with:
|
|
```bash
|
|
$ docker compose exec greenlight bundle exec rake admin:create
|
|
```
|
|
|
|
## Further How-To's
|
|
- [Upgrading](docs/upgrading.md)
|
|
- [Running behind NAT](docs/behind-nat.md)
|
|
- [BBB-Docker Development](docs/development.md)
|
|
- [Integration into an existing web server](docs/existing-web-server.md)
|
|
|