extern/docker
1
0
Fork 1
mirror of https://github.com/bigbluebutton/docker.git synced 2025-05-10 02:24:47 +02:00
Code Issues Packages Projects Releases Wiki Activity
Docker files for BigBlueButton
600 Commits 18 Branches 0 Tags 2.1 MiB
Shell 59.9%
Dockerfile 40.1%
develop
Go to file
chandi Langecker b627949e22
Merge pull request #352 from tibroc/update-bbb-build 
update bbb-build container tag
2025-04-29 22:58:19 +00:00
.cache bbb-graphql-middleware dev mode 2024-11-25 17:50:15 +01:00
conf freeswitch: SIP dial in support 2024-11-29 00:13:44 +01:00
data bbb3.0: graphql container, postgres with multiple db, repo updates 2024-01-07 23:44:54 +01:00
docs docs: minor additions 2025-03-27 00:33:16 +01:00
mod add safari fix for v3.0.4, closes #348 2025-03-28 16:32:20 +01:00
repos update to 3.0.4 2025-03-26 19:16:36 +01:00
scripts use always latest bbb-build version 2025-03-28 21:23:59 +01:00
.gitignore .gitignore: conf/bbb-html5.yml 2024-11-24 19:14:56 +01:00
.gitmodules v3.0.0-beta.5: recording via bbb-webrtc-recorder and etherpad export 2024-11-24 21:26:31 +01:00
CHANGELOG.md Release v3.0.4 2025-03-27 01:19:21 +01:00
dev.env bbb-graphql-middleware dev mode 2024-11-25 17:50:15 +01:00
docker-compose.tmpl.yml fix postgres migration 2025-03-12 00:47:16 +01:00
LICENSE Initial commit 2017-10-27 14:57:35 -04:00
README.md Merge pull request #347 from tibroc/3.0.4 2025-03-26 23:50:26 +00:00
sample.env lets encrypt: email required, remove staging flag 2024-11-28 13:04:33 +01:00

README.md

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