docker/README.md

2.1 KiB

BigBlueButton 2.3 Docker

not ready for production | Changelog | 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
    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
    $ git clone --recurse-submodules https://github.com/bigbluebutton/docker.git bbb-docker
    $ cd bbb-docker
    
  3. Run setup:
    $ ./scripts/setup
    
  4. (optional) Make additional configuration adjustments
    $ nano .env
    # always recreate the docker-compose.yml file after making any changes
    $ ./scripts/generate-compose
    
  5. Start containers:
    $ docker-compose up -d
    
  6. If you use greenlight, you can create an admin account with:
    $ docker-compose exec greenlight bundle exec rake admin:create
    

Further How-To's