openvidu/openvidu-server/docker/openvidu-docker-compose/readme.md

66 lines
2.9 KiB
Markdown

# Deploy Openvidu using Docker Compose
In this repository we explain how deploy a video call application stack using Openvidu Server and Openvidu Call.
## 1. Prerequisites:
This docker-compose running in Ubuntu 16.04 or Ubuntu 18.04. We need have a docker and docker-compose installed in the machine. For this propuse we proportionally the next documentation for how install docker and docker compose in Ubuntu.
- [Install Docker](https://docs.docker.com/install/linux/docker-ce/ubuntu/)
- [Install Docker Compose](https://docs.docker.com/compose/install/)
We need open the next ports in the host:
- 80 TCP (Letsencrypt getting certificated by default in this port)
- 443 TCP (OpenVidu Server and Openvidu Call view Services section for more information)
- 3478 TCP (coturn listens on port 3478 by default)
- 3478 UDP (opening also UDP port has been proved to facilitate connections with certain type of clients)
- 40000 - 57000 UDP (Kurento Media Server listens on this ports)
- 40000 - 57000 UDP (Kurento Media Server listens on this ports)
- 57001 - 65535 UDP (WebRTC connections with clients may be established using a random port inside this range)
- 57001 - 65535 TCP (WebRTC connections with clients may be established using a random port inside this range, if UDP can't be used because client network is blocking it)
## 2. Deploy
### Clone Repository
First clone this repository:
`$ git clone https://github.com/OpenVidu/openvidu.git`
Change to this directory:
`cd openvidu/openvidu-server/docker/openvidu-docker-compose`
### Configure enviroment variables
Open the file `.env` and configure the following variables:
- OPENVIDU_SECRET: Used for apps and to acces to the inspector. Change it with yout secret
- DOMAIN_OR_PUBLIC_IP: Used for access the application, write the ip if you don't have a dns name or use your dns name if you have one
- OPENVIDU_RECORDING_FOLDER: Used for openvidu server recorder, select a valid folder for your host
- CERTIFICATE_TYPE: Only used if you have a dns name. Choose selfsigned for generate autfirmated certificated, this option will show a error menssage. Choose owncert if you have a certificateds or choose letsencrypt for auto generate certificated using letsencrypt.
- LETSENCRYPT_EMAIL: If you use letsencrypt certificated you need configurate a valid email for this propuse
### Deployment application
The application Openvidu Call is deployment by default in this docker-compose. The configuration of this application can will see in the file `docker-compose.override.yml`.
If your want deploy your own application change the `app` service in the `docker-compose.override.yml`. Just keep in mind expose your own application in the port `5442` and use `http`.
### Run the application
For to start the application exec this command:
`docker-compose up`
When you see the message in console `OPENVIDU SERVER IP` the page is ready for enjoy it
### Stop the application
For to stop the application exec this command:
`docker-compose down`