mirror of
https://github.com/bigbluebutton/docker.git
synced 2024-10-05 09:42:01 +02:00
65 lines
2.1 KiB
Markdown
65 lines
2.1 KiB
Markdown
# BigBlueButton 2.3 Docker
|
|
|
|
not ready for production | [Changelog](CHANGELOG.md) | [Issues](https://github.com/bigbluebutton/docker/issues)
|
|
|
|
## Important
|
|
**This Repository - and BBB 2.3 itself - are still in an early state. Don't use it in production yet!** \
|
|
Testing and further development welcome :)
|
|
|
|
you can find a **stable bbb-docker release for 2.2** here: https://github.com/alangecker/bigbluebutton-docker
|
|
|
|
|
|
## Features
|
|
- Easy installation
|
|
- Greenlight included
|
|
- TURN server included
|
|
- Fully automated HTTPS certificates
|
|
- Full IPv6 support
|
|
- Runs on any major linux distributon (Debian, Ubuntu, CentOS,...)
|
|
|
|
## What does not work
|
|
- probably a lot - it's in an alpha state!
|
|
- Load balancing of html5 meteor processes
|
|
- bbb-lti
|
|
|
|
## Install
|
|
1. 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 and that you use a version ≥ 1.28 : `$ docker-compose --version`
|
|
2. Clone this repository
|
|
```sh
|
|
$ git clone --recurse-submodules https://github.com/bigbluebutton/docker.git bbb-docker
|
|
$ cd bbb-docker
|
|
```
|
|
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
|
|
```
|
|
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)
|
|
|