OVHserver/opt/02-core/bigbluebutton/docs/development.md
SamoilenkoVadym 256cdc2a04 feat: добавлен BigBlueButton для проведения workshops
- Установлен BigBlueButton с Greenlight v3 frontend
- Настроен SMTP через Microsoft 365 Relay (aiimpress-com0e.mail.protection.outlook.com:25)
- Email отправка работает: noreply@ai-impress.com
- Доступ: https://bbb.ai-impress.com
- Настроена интеграция с Traefik для SSL
- Включены: запись вебинаров (90 дней), webhooks для n8n, Prometheus экспорт
- Локаль: русский язык (ru-RU)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-08 21:13:40 +00:00

1.9 KiB

bbb-docker Development

Basics

normally people start BBB with the pre-built docker images, but for developing you need to build them by yourself. For that you need to ensure that the submodules are also checked out

$ git clone --recurse-submodules https://github.com/bigbluebutton/docker.git bbb-dev
$ cd bbb-dev

Running

you can now run bbb-docker locally by simply starting

$ ./scripts/dev

Use the API Mate with the link presented in the console to create & join a conference.

Hints

  • the html5 component will watch and automatically reload on any changes 🚀
  • if you change anything in the other components, you need to
    • manually rebuilt it
      $ docker compose build CONTAINERNAME
    • restart it
      $ docker compose up -d CONTAINERNAME
  • if you change any variable in .env, always run following to rebuild the docker-compose.yml`` $ ./scripts/generate-compose`
  • view the logs with
    $ docker compose logs -f
  • At some point your browser will warn you about an invalid certificate, but you can press "Accept the Risk and Continue" / "Proceed to 10.7.7.1 (unsafe)"

Notes

  • Due to the self signed ssl certificate it is currently not possible to notify greenlight about recordings in dev mode

How to do create a new update for a newer BBB release?

This always consists out of following steps

  1. Get an understanding about changes that happened and find out what changes to bbb-docker that require. \
  2. Apply these changes to this project.
    • Often you only need to checkout the git submodules to the specific release tag
      • List of all submodules: git submodule
  3. Test everything (with firefox and chromium/chrome)
    • Audio
    • Video
    • Presentation upload
    • Shared Notes
  4. Create a CHANGELOG.md entry
  5. Create a Pull Request
  6. Receive big thanks from @alangecker