Skip to content

bigbluebutton/docker

Folders and files

NameName
Last commit message
Last commit date

Latest commit

b627949 Â· Apr 29, 2025
Nov 25, 2024
Nov 28, 2024
Jan 7, 2024
Mar 26, 2025
Mar 28, 2025
Mar 26, 2025
Mar 28, 2025
Nov 24, 2024
Nov 24, 2024
Mar 27, 2025
Oct 27, 2017
Mar 26, 2025
Nov 25, 2024
Mar 11, 2025
Nov 28, 2024

Repository files navigation

bbb-docker-banner

📦 BigBlueButton 3.0 Docker

Version: 3.0.4 | 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,...)

currently missing / broken

  • NAT support
  • bbb-transcription-controller
  • livekit

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)
  • firewall allows internal networking (e.g. for ufw: ufw allow 10.7.7.0/24)
  • git installed

Install production server

  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
    
    # optional: use the more stable main branch (often much 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

Development setup

  1. Clone this repository
    $  git clone --recurse-submodules https://github.com/bigbluebutton/docker.git bbb-dev
  2. Start dev server
    $ cd bbb-dev
    $ ./scripts/dev
  3. Use API Mate with the link presented in the console to create & join a conference

Further How-To's