Back to Templates
Oryx logo

Oryx

v5.15.20

Oryx (formerly SRS Stack) is an all-in-one, open-source video streaming server with a web console. It ingests RTMP, WebRTC (WHIP) and SRT streams and plays them back over HLS, HTTP-FLV and WebRTC (WHEP), with built-in recording, forwarding, transcoding and virtual live streaming.

Deploy on Notploy

How to deploy

Deploy Oryx on Notploy

  1. Install Notploy on your server if you haven't already.
  2. In your Notploy panel, open a project and click Create Service → Template.
  3. Search for Oryx and click Create — Notploy configures domains, environment variables, and volumes for you.

Alternatively, create a Compose service, go to Advanced → Import from Base64, and paste this payload:

base64
ewogICJjb21wb3NlIjogIiMgZG9rcGxveTogYWxsb3ctaG9zdC1wb3J0cyDigJQgUlRNUCAoMTkzNS90Y3ApLCBXZWJSVEMgKDgwMDAvdWRwKSBhbmQgU1JUICgxMDA4MC91ZHApIGFyZSBzdHJlYW1pbmcgcHJvdG9jb2xzIFRyYWVmaWsgY2Fubm90IHJvdXRlOyB0aGV5IG11c3QgYmUgcHVibGlzaGVkIG9uIHRoZSBob3N0Llxuc2VydmljZXM6XG4gIG9yeXg6XG4gICAgaW1hZ2U6IG9zc3JzL29yeXg6NS4xNS4yMFxuICAgIHJlc3RhcnQ6IHVubGVzcy1zdG9wcGVkXG4gICAgcG9ydHM6XG4gICAgICAjIFJUTVAsIFdlYlJUQyBhbmQgU1JUIGFyZSBub3QgSFRUUCBwcm90b2NvbHMsIHNvIFRyYWVmaWsgY2Fubm90IHJvdXRlXG4gICAgICAjIHRoZW0gdGhyb3VnaCB0aGUgZG9tYWluLiBUaGV5IG11c3QgYmUgcHVibGlzaGVkIGRpcmVjdGx5IG9uIHRoZSBob3N0XG4gICAgICAjIChzYW1lIGFwcHJvYWNoIGFzIHRoZSBwb3N0ZS5pbyB0ZW1wbGF0ZSB3aXRoIGl0cyBtYWlsIHBvcnRzKS4gVXNlIHRoZVxuICAgICAgIyBzZXJ2ZXIgSVAgKG5vdCB0aGUgZG9tYWluKSBmb3IgdGhlc2UgcHJvdG9jb2xzLlxuICAgICAgLSBcIjE5MzU6MTkzNVwiICMgUlRNUCBpbmdlc3QvcGxheWJhY2sgKFRDUClcbiAgICAgIC0gXCI4MDAwOjgwMDAvdWRwXCIgIyBXZWJSVEMgbWVkaWEgdHJhbnNwb3J0IChVRFApXG4gICAgICAtIFwiMTAwODA6MTAwODAvdWRwXCIgIyBTUlQgaW5nZXN0L3BsYXliYWNrIChVRFApXG4gICAgdm9sdW1lczpcbiAgICAgIC0gb3J5eC1kYXRhOi9kYXRhXG5cbnZvbHVtZXM6XG4gIG9yeXgtZGF0YToge30iLAogICJjb25maWciOiAiW3ZhcmlhYmxlc11cbm1haW5fZG9tYWluID0gXCIke2RvbWFpbn1cIlxuXG5bY29uZmlnXVxuW1tjb25maWcuZG9tYWluc11dXG5zZXJ2aWNlTmFtZSA9IFwib3J5eFwiXG5wb3J0ID0gMjAyMlxuaG9zdCA9IFwiJHttYWluX2RvbWFpbn1cIiIKfQ==

Reference files

Configuration

The exact Docker Compose and template configuration this template deploys.

Usage guide

Instructions

Oryx (SRS Stack)

Oryx is an all-in-one video streaming server built on SRS, with a web console for managing streams, recording, forwarding, transcoding and virtual live streaming.

First login

Open the domain assigned to this service. On the first visit Oryx asks you to create the admin password — set it right away, since anyone who reaches the page first can claim the instance. The password (and all other state) is stored in the oryx-data volume, so it survives restarts and upgrades.

Publishing streams

The web console (Scenarios > Streaming) shows ready-to-copy URLs that include your stream secret. The streaming protocols are not HTTP, so Traefik cannot route them through your domain — they are published directly on the server's host ports instead. Use the server IP address (not the domain) for these:

ProtocolURL formatHost port
RTMP (OBS, ffmpeg)rtmp://SERVER_IP/live/livestream?secret=xxx1935/tcp
SRTsrt://SERVER_IP:10080?streamid=#!::r=live/livestream,secret=xxx,m=publish10080/udp
WebRTC (WHIP)https://your-domain/rtc/v1/whip/?app=live&stream=livestream&secret=xxxsignaling via domain, media via 8000/udp

Make sure your server firewall / cloud security group allows 1935/tcp, 8000/udp and 10080/udp. Because these are fixed host ports, only one Oryx instance can run per server.

Playback

HTTP-based playback goes through your domain (HTTPS via Traefik):

  • HLS: https://your-domain/live/livestream.m3u8
  • HTTP-FLV: https://your-domain/live/livestream.flv
  • WebRTC (WHEP): available from the console's preview page; media flows over 8000/udp.

If WebRTC playback or publishing connects but produces no media, verify that UDP port 8000 is reachable from the client — WebRTC media bypasses the reverse proxy entirely.

More like this

Free and open source

Self-host Oryx in minutes

Notploy is a free, open source deployment platform. Deploy Oryx and 571+ other templates on your own infrastructure with a single click.