migoller/live555proxyserverdocker repository overview

⁠LIVE555 Proxy Server

The LIVE555 Proxy Server⁠ is a unicast RTSP server - built from the LIVE555 Streaming Media software⁠ - that acts as a 'proxy' for one or more 'back-end' unicast or multicast RTSP/RTP streams (i.e., served by other server(s)).

The key feature of a proxy server is that it reads each 'back-end' stream only once, regardless of how many separate clients are streaming from the proxy server. This makes the proxy server ideal, for example, for streaming from a RTSP-enabled video camera (which might not be able to handle more than one connection at a time).

                                                          --> [RTSP client1]
    [back-end RTSP/RTP stream] --> [LIVE555 Proxy Server] --> [RTSP client2]
                                                          ...
                                                          --> [RTSP clientN]

⁠LIVE555 Proxy Server for Docker

The LIVE555 Proxy Server⁠ for Docker image proxies one or more back-end RTSP/RTP streams to one or more clients.

Just provide the RTSP urls to your Docker container as the command property. The container will serve the streams for your clients.

• A single back-end stream will be proxied to the endpoint rtsp://hostname:[554|80]/proxyStream
• multiple back-end streams will be proxied to corresponding endpoints rtsp://hostname:[554|80]/proxyStream-1, rtsp://hostname:[554|80]/proxyStream-2, ..., rtsp://hostname:[554|80]/proxyStream-n

The container will support RTSP over HTTP access on port 80.

⁠Running a single container

To run a LIVE555 Proxy Server for Docker container out of the box just type:

    $ docker run -d \
        -p 8080:80 \
        -p 554:554 \
        -v /etc/localtime:/etc/localtime:ro \
        -v /etc/timezone:/etc/timezone:ro \
        migoller/live555proxyserverdocker \
        <url1> <url2> ... <urln>

⁠Running the containter with docker-compose

To let docker-compose create an run your container you'll have to create a docker-compose.yml file.

version: '2'
services:
  proxy:
    image: migoller/live555proxyserverdocker
    command: -v <url1> <url2>
    volumes:
      - /etc/localtime:/etc/localtime:ro
      - /etc/timezone:/etc/timezone:ro
    ports:
      - "554:554"
      - "8080:80"