docker/README.md
chandi 07ce2c483c by default docker should use the prebuilt images.
in same cases docker still tries to build it, exceeding the RAM requirement and often failing due to the missing submodules
2023-12-08 12:04:14 +01:00

2.2 KiB

bbb-docker-banner

📦 BigBlueButton 2.7 Docker

Version: 2.7.3 | Changelog | 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
    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
    $ git clone 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:
    $ ./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 --no-build
    
  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