{"id":22191805,"url":"https://github.com/bigbluebutton/docker","last_synced_at":"2025-05-15T08:08:36.794Z","repository":{"id":37270161,"uuid":"108583481","full_name":"bigbluebutton/docker","owner":"bigbluebutton","description":"Docker files for BigBlueButton","archived":false,"fork":false,"pushed_at":"2025-04-02T10:05:54.000Z","size":1191,"stargazers_count":392,"open_issues_count":121,"forks_count":253,"subscribers_count":28,"default_branch":"develop","last_synced_at":"2025-04-11T23:29:20.547Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"lgpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bigbluebutton.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2017-10-27T18:57:34.000Z","updated_at":"2025-04-07T04:29:33.000Z","dependencies_parsed_at":"2023-12-07T19:30:50.481Z","dependency_job_id":"252dcf2c-5d9f-4013-b5a7-16b8d1fd771a","html_url":"https://github.com/bigbluebutton/docker","commit_stats":{"total_commits":447,"total_committers":43,"mean_commits":"10.395348837209303","dds":0.3221476510067114,"last_synced_commit":"8c0409fa5348ebd37a678ae002a0c3062ee46372"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bigbluebutton%2Fdocker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bigbluebutton%2Fdocker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bigbluebutton%2Fdocker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bigbluebutton%2Fdocker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bigbluebutton","download_url":"https://codeload.github.com/bigbluebutton/docker/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248642308,"owners_count":21138350,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-12-02T12:17:50.837Z","updated_at":"2025-04-12T22:34:29.388Z","avatar_url":"https://github.com/bigbluebutton.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cimg width=\"1012\" alt=\"bbb-docker-banner\" src=\"https://user-images.githubusercontent.com/1273169/141153216-0386cd4e-0aaf-473a-8f42-a048e52ed0d7.png\"\u003e\n\n\n# 📦 BigBlueButton 3.0 Docker\n\nVersion: 3.0.4 | [Changelog](CHANGELOG.md) | [Issues](https://github.com/bigbluebutton/docker/issues) | [Upgrading](docs/upgrading.md) | [Development](docs/development.md)\n\n## Features\n- Easy installation\n- Greenlight included\n- TURN server included\n- Fully automated HTTPS certificates\n- Full IPv6 support\n- Runs on any major linux distributon (Debian, Ubuntu, CentOS,...)\n\n## currently missing / broken\n- NAT support\n- bbb-transcription-controller\n- livekit\n\n## Requirements\n- 4GB of RAM\n- Linux (it will not work under Windows/WSL)\n- Root access (bbb-docker uses host networking, so it won't work with Kubernetes, any \"CaaS\"-Service, etc.)\n- Public IPv4 (expect issues with a firewall / NAT)\n- firewall allows internal networking (e.g. for ufw: `ufw allow 10.7.7.0/24`)\n- git installed\n\n## Install production server\n1. Ensure the requirements above are fulfilled (it really doesn't work without them)\n2. Install docker-ce \u0026 docker-compose-plugin\n    1. follow instructions\n        * Debian: https://docs.docker.com/engine/install/debian/\n        * CentOS: https://docs.docker.com/engine/install/centos/\n        * Fedora: https://docs.docker.com/engine/install/fedora/\n        * Ubuntu: https://docs.docker.com/engine/install/ubuntu/\n    2. Ensure docker works with `$ docker run hello-world`\n    3. Ensure you use a docker version ≥ 23.0 : `$ docker --version`\n3. Clone this repository\n   ```sh\n   $ git clone https://github.com/bigbluebutton/docker.git bbb-docker\n   $ cd bbb-docker\n\n   # optional: use the more stable main branch (often much older)\n   $ git checkout main \n   ```\n4. Run setup:\n   ```bash\n   $ ./scripts/setup\n   ```\n5. (optional) Make additional configuration adjustments\n   ```bash\n   $ nano .env\n   # always recreate the docker-compose.yml file after making any changes\n   $ ./scripts/generate-compose\n   ```\n6. Start containers:\n    ```bash\n    $ docker compose up -d --no-build\n    ```\n7. If you use greenlight, you can create an admin account with:\n    ```bash\n    $ docker compose exec greenlight bundle exec rake admin:create\n    ```\n\n## Development setup\n1. Clone this repository\n   ```sh\n   $  git clone --recurse-submodules https://github.com/bigbluebutton/docker.git bbb-dev\n   ```\n2. Start dev server\n   ```sh\n   $ cd bbb-dev\n   $ ./scripts/dev\n   ```\n3. Use API Mate with the link presented in the console to create \u0026 join a conference\n\n\n## Further How-To's\n\u003c!-- - [Running behind NAT](docs/behind-nat.md) --\u003e\n- [Integration into an existing web server](docs/existing-web-server.md)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbigbluebutton%2Fdocker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbigbluebutton%2Fdocker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbigbluebutton%2Fdocker/lists"}