# 📦 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 --recurse-submodules 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 ``` 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)