# Getting Started

## Getting Started with Docker Image

OvenMediaEngine provides Docker images from AirenSoft's Docker Hub (airensoft/ovenmediaengine) repository. You can easily use OvenMediaEngine server by using Docker image. See [Getting Started with Docker](https://docs.ovenmediaengine.com/0.19.0/getting-started/getting-started-with-docker) for details.

## Getting Started with Source Code

### Installing dependencies

OvenMediaEngine can work with a variety of open-sources and libraries. First, install them on your clean Linux machine as described below. We think that OME can support most Linux packages, but the tested platforms we use are Ubuntu 18+, Fedora 28+, Rocky Linux 8+, and AlmaLinux 8+.

```bash
curl -LOJ https://github.com/AirenSoft/OvenMediaEngine/archive/refs/tags/v0.19.0.tar.gz && \
tar xvfz OvenMediaEngine-0.19.0.tar.gz && \
OvenMediaEngine-0.19.0/misc/prerequisites.sh
```

{% hint style="info" %}
If the prerequisites.sh script fails, try to run `sudo apt-get update` and rerun it. If it's not enough proceed with the [manual installation](https://docs.ovenmediaengine.com/0.19.0/troubleshooting#prerequisites-sh-script-failed).
{% endhint %}

### **Building & Running**

You can build the OvenMediaEngine source using the following command:

{% tabs %}
{% tab title="Ubuntu 18" %}

```bash
sudo apt-get update
cd OvenMediaEngine-0.19.0/src
make release
sudo make install
systemctl start ovenmediaengine
# If you want automatically start on boot
systemctl enable ovenmediaengine.service 
```

{% endtab %}

{% tab title="Fedora 28" %}

```bash
sudo dnf update
cd OvenMediaEngine-0.19.0/src
make release
sudo make install
systemctl start ovenmediaengine
# If you want automatically start on boot
systemctl enable ovenmediaengine.service
```

{% endtab %}

{% tab title="Rocky Linux 8" %}

```bash
sudo dnf update
cd OvenMediaEngine-0.19.0/src
make release
sudo make install
systemctl start ovenmediaengine
# If you want automatically start on boot
systemctl enable ovenmediaengine.service
```

{% endtab %}

{% tab title="AlmaLinux 8" %}

```bash
sudo dnf update
cd OvenMediaEngine-0.19.0/src
make release
sudo make install
systemctl start ovenmediaengine
# If you want automatically start on boot
systemctl enable ovenmediaengine.service
```

{% endtab %}
{% endtabs %}

{% hint style="info" %}
if `systemctl start ovenmediaengine` fails in Fedora, SELinux may be the cause. See [Check SELinux section of Troubleshooting](https://docs.ovenmediaengine.com/0.19.0/troubleshooting#check-selinux).
{% endhint %}

## Ports used by default

The default configuration uses the following ports, so you need to open it in your firewall settings.

| Port                        | Purpose                                                                                                                                   |
| --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| 1935/TCP                    | RTMP Input                                                                                                                                |
| 9999/UDP                    | SRT Input                                                                                                                                 |
| 4000/UDP                    | MPEG-2 TS Input                                                                                                                           |
| 9000/TCP                    | Origin Server (OVT)                                                                                                                       |
| <p>3333/TCP<br>3334/TLS</p> | <p>LLHLS Streaming<br><mark style="color:red;"><strong>\* Streaming over Non-TLS is not allowed with modern browsers.</strong></mark></p> |
| <p>3333/TCP<br>3334/TLS</p> | WebRTC Signaling (both ingest and streaming)                                                                                              |
| 3478/TCP                    | WebRTC TCP relay (TURN Server, both ingest and streaming)                                                                                 |
| 10000 - 10009/UDP           | WebRTC Ice candidate (both ingest and streaming)                                                                                          |

{% hint style="warning" %}
To use TLS, you must set up a certificate. See [TLS Encryption](https://docs.ovenmediaengine.com/0.19.0/configuration/tls-encryption) for more information.
{% endhint %}

You can open firewall ports as in the following example:

```bash
$ sudo firewall-cmd --add-port=3333/tcp
$ sudo firewall-cmd --add-port=3334/tcp
$ sudo firewall-cmd --add-port=1935/tcp
$ sudo firewall-cmd --add-port=9999/udp
$ sudo firewall-cmd --add-port=4000/udp
$ sudo firewall-cmd --add-port=3478/tcp
$ sudo firewall-cmd --add-port=9000/tcp
$ sudo firewall-cmd --add-port=10000-10009/udp
```