mirror of
https://github.com/bigbluebutton/docker.git
synced 2024-12-28 01:29:11 +01:00
122 lines
2.6 KiB
Markdown
122 lines
2.6 KiB
Markdown
# BigBlueButton Docker
|
|
|
|
## 1. Install docker-ce
|
|
|
|
This container depends on docker-ce.
|
|
|
|
1 - Make sure you don't have docker installed:
|
|
`sudo apt-get remove docker docker-engine docker.io`
|
|
|
|
2 - Install docker-ce:
|
|
```
|
|
sudo apt-get update;
|
|
sudo apt-get install \
|
|
apt-transport-https \
|
|
ca-certificates \
|
|
curl \
|
|
software-properties-common;
|
|
|
|
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
|
|
|
|
sudo add-apt-repository \
|
|
"deb [arch=amd64] https://download.docker.com/linux/ubuntu \
|
|
$(lsb_release -cs) \
|
|
stable"
|
|
|
|
sudo apt-get update
|
|
|
|
sudo apt-get install docker-ce
|
|
|
|
sudo addgroup `whoami` docker
|
|
|
|
```
|
|
|
|
## 2. Clone this repository
|
|
```
|
|
mkdir -p ~/bbb/src/
|
|
cd ~/bbb/
|
|
git clone https://github.com/bigbluebutton/docker.git
|
|
cd docker
|
|
git checkout v2.2.x
|
|
```
|
|
|
|
## 3. Clone BBB sources repository (optional)
|
|
```
|
|
cd ~/bbb/src/
|
|
git clone https://github.com/bigbluebutton/bigbluebutton.git
|
|
```
|
|
|
|
## 4. Setup SSL certificate
|
|
Generate a certificate to your container (using letsencrypt or other solution) and then copy your certificate to certs/ folder with the commands:
|
|
```
|
|
mkdir certs/
|
|
cp fullchain.pem certs/
|
|
cp privkey.pem certs/
|
|
```
|
|
|
|
## 5. Creating container
|
|
In order to create the container you must specify the hostname of container and the domain name.
|
|
|
|
In this example your container will be acessible from https://bbb001.bbbvm.imdt.com.br :
|
|
|
|
```
|
|
docker-compose build bbb22
|
|
NAME=bbb001 DOMAIN=bbbvm.imdt.com.br sh -c 'docker-compose run --name $NAME bbb22'
|
|
```
|
|
## 6. Add an entry in your `/etc/hosts` file
|
|
|
|
In order to access the container, you need to get the IP address of container by running the following command:
|
|
|
|
```
|
|
docker exec -it bbb001 ifconfig eth0
|
|
```
|
|
|
|
After that, add a line in your `/etc/hosts` file with the full domain name specified at previous step.
|
|
|
|
In this example, the line added on hosts file is:
|
|
```
|
|
172.20.0.2 bbb001.bbbvm.imdt.com.br
|
|
```
|
|
|
|
## 7. Open the specified address in your browser:
|
|
|
|
http://bbb001.bbbvm.imdt.com.br
|
|
|
|
|
|
# Useful commands
|
|
|
|
## Start container (after host reboot)
|
|
```
|
|
docker start bbb001
|
|
docker attach bbb001
|
|
```
|
|
|
|
## Stop the container
|
|
```
|
|
docker stop bbb001
|
|
```
|
|
|
|
## Kill the container (force exit)
|
|
```
|
|
docker kill bbb001
|
|
```
|
|
|
|
# MAC users
|
|
Docker for Mac OS doesn't allow direct access to container IP's.
|
|
|
|
In order to access the BBB container from your MAC os host, you can use openvpn:
|
|
|
|
1. Build containers:
|
|
```
|
|
docker-compose build mac_proxy mac_openvpn
|
|
```
|
|
|
|
2. Add `comp-lzo no` at bottom of `mac-vpn/docker-for-mac.ovpn`
|
|
|
|
3. Install openvpn configuration generated on `mac-vpn/docker-for-mac.ovpn` (double click and open on Tunnelblick)
|
|
|
|
4. Start containers
|
|
```
|
|
docker-compose start mac_proxy mac_openvpn
|
|
```
|