thbe/sls repository overview

⁠SLS on Docker

This Docker image could be used to run an SRT Live Server (SLS) instance. The Docker image is based on the official Alpine Linux⁠.

⁠Table of Contents

• Install Docker⁠
• Download⁠
• How to use this image⁠
• Next steps⁠
• Update Docker image⁠
• Advanced usage⁠
• Technical details⁠
• Development⁠

⁠Install Docker

To use this image you have to install Docker⁠ first.

⁠Download

You can get the trusted build from the Docker Hub registry⁠:

docker pull thbe/sls

Alternatively, you may build the Docker image from the source code⁠ on GitHub.

⁠How to use this image

⁠Start the sls instance

The instance can be started as follow:

docker run --detach --restart always --name sls --hostname sls.$(hostname -d) -p 9710:9710/udp thbe/sls

⁠Check server status

You can use the standard Docker commands to examine the status of the sls instance:

docker logs --tail 1000 --follow --timestamps sls

⁠Use server

Example Sending of SRT in OBS:

• In the setup menu under "Stream", select "Custom..." leave the Key field blank.
• Put the following url to send to your docker container: srt://your.server.ip:9710?streamid=publish/stream/yourstreamname

Example of Receiving of SRT in OBS:

• Add a Media Source
• Put the following url to receive: srt://your.server.ip:9710?streamid=stream/live/yourstreamname

⁠Example usage

You can find the blog article virtual come together⁠ on my website that shows a real life usage example of SLS.

⁠Next steps

The next release of this Docker image should have a persistent sls configuration outside of the docker image.

⁠Update Docker image

Simply download the trusted build from the Docker Hub registry⁠:

docker pull thbe/sls

⁠Advanced usage

⁠Build from source code

You can build the image also from source. To do this you have to clone the docker-sls⁠ repository from GitHub:

git clone https://github.com/thbe/docker-sls.git
cd docker-sls
docker build --rm --no-cache -t thbe/sls .

⁠Bash shell inside container

If you need a shell inside the container you can run the following command:

docker exec -ti sls /bin/sh

⁠Technical details

• Alpine base image
• srt and sls source code from official Github repository

⁠Development

If you like to add functions or improve this Docker image, feel free to fork the repository and send me a merge request with the modification.