Docker files for BigBlueButton
Go to file
2023-12-08 12:32:50 +01:00
conf sip_profiles: add extension field 2020-09-02 12:05:00 +02:00
docs updating docs for release v2.7.3 2023-12-08 12:24:37 +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 updating docs for release v2.7.3 2023-12-08 12:24:37 +01:00
docker-compose.tmpl.yml Merge pull request #307 from bigbluebutton/repo-restructure 2023-12-08 12:04:30 +01:00
LICENSE Initial commit 2017-10-27 14:57:35 -04:00
README.md README: remove docker-compose version check, repeat requirements again, more links on top 2023-12-08 12:32:50 +01:00
sample.env Add RESOLVER_ADDRESS env variable for HTTPS_PROXY container. 2023-06-02 09:52:19 +02:00

bbb-docker-banner

📦 BigBlueButton 2.7 Docker

Version: 2.7.3 | Changelog | Issues | Upgrading | Development

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 Windows/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. Ensure the requirements above are fulfilled (it really doesn't work without them)
  2. Install docker-ce & docker-compose-plugin
    1. follow instructions
    2. Ensure docker works with $ docker run hello-world
    3. Ensure you use a docker version ≥ 23.0 : $ docker --version
  3. 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 
    
  4. Run setup:
    $ ./scripts/setup
    
  5. (optional) Make additional configuration adjustments
    $ nano .env
    # always recreate the docker-compose.yml file after making any changes
    $ ./scripts/generate-compose
    
  6. Start containers:
    $ docker compose up -d --no-build
    
  7. If you use greenlight, you can create an admin account with:
    $ docker compose exec greenlight bundle exec rake admin:create
    

Further How-To's