extern/docker
1
0
Fork 1
mirror of https://github.com/bigbluebutton/docker.git synced 2025-06-20 19:58:48 +02:00
Code Issues Packages Projects Releases Wiki Activity

update README.md for bigbluebutton/docker

Browse Source
This commit is contained in:
chandi 2021-02-11 16:01:32 +01:00
parent 124ba5731f
commit 19cdbe0aaa
1 changed files with 24 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

38
README.md
View File

@ -1,14 +1,26 @@
# BigBlueButton Docker # 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
[Changelog](CHANGELOG.md) | [Issues](https://github.com/alangecker/bigbluebutton-docker/issues)
## Features ## Features
- Easy installation - Easy installation
- Greenlight included - Greenlight included
- TURN server included - TURN server included
- Fully automated HTTPS certificates - Fully automated HTTPS certificates
- Runs on almost any major linux distributon (Debian, Ubuntu, CentOS,...)
- Full IPv6 support - 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 ## Install
1. Install docker-ce & docker-compose 1. Install docker-ce & docker-compose
@ -19,22 +31,22 @@
* Ubuntu: https://docs.docker.com/engine/install/ubuntu/ * Ubuntu: https://docs.docker.com/engine/install/ubuntu/
2. Ensure docker works with `$ docker run hello-world` 2. Ensure docker works with `$ docker run hello-world`
3. Install docker-compose: https://docs.docker.com/compose/install/ 3. Install docker-compose: https://docs.docker.com/compose/install/
4. Ensure docker-compose works: `$ docker-compose --version` 4. Ensure docker-compose works and that you use a version ≥ 1.28 : `$ docker-compose --version`
5. Clone this repository 2. Clone this repository
```sh ```sh
$ git clone --recurse-submodules https://github.com/alangecker/bigbluebutton-docker.git bbb-docker $ git clone --recurse-submodules https://github.com/bigbluebutton/docker.git bbb-docker
$ cd bbb-docker $ cd bbb-docker
``` ```
6. Run setup: 3. Run setup:
```bash ```bash
$ ./scripts/setup $ ./scripts/setup
``` ```
4. (optional) Make additional configuration adjustments 4. (optional) Make additional configuration adjustments
```bash ```bash
$ nano .env $ nano .env
# always recreate the docker-compose.yml file after making any changes # always recreate the docker-compose.yml file after making any changes
$ ./scripts/generate-compose $ ./scripts/generate-compose
``` ```
5. Start containers: 5. Start containers:
```bash ```bash
$ docker-compose up -d $ docker-compose up -d
@ -44,11 +56,9 @@
$ docker-compose exec greenlight bundle exec rake admin:create $ docker-compose exec greenlight bundle exec rake admin:create
``` ```
## How-To's ## Further How-To's
- [Upgrade](docs/upgrading.md) - [Upgrading](docs/upgrading.md)
- [Behind NAT](docs/behind-nat.md) - [Running behind NAT](docs/behind-nat.md)
- [BBB-Docker Development](docs/development.md) - [BBB-Docker Development](docs/development.md)
- [Integration into an existing web server](docs/existing-web-server.md) - [Integration into an existing web server](docs/existing-web-server.md)
## 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.