Kurento media server Docker image

What is Kurento media server?

Kurento is an open source software project providing a platform suitable for creating modular applications with advanced real-time communication capabilities.

Kurento is part of FIWARE. For further information on the relationship of FIWARE and Kurento check the Kurento FIWARE Catalog Entry

Kurento is part of the NUBOMEDIA research initiative.

www.kurento.org

github.com/kurento

Documentation

The Kurento project provides detailed documentation including tutorials, installation and development guides. A simplified version of the documentation can be found on readthedocs.org. The Open API specification a.k.a. Kurento Protocol is also available on apiary.io.

How to use this image

Starting a Kurento instance is easy. Kurento exposes port 8888 for client access. So, assuming you want to map port 8888 in the instance to local port 8888, you can start Kurento with:

docker run -d --name=kms -p 8888:8888 instrumentisto/kurento-media-server

Logs

Kurento log is available through the usual way Docker exposes logs for its containers. So assuming you named your container kms (with--name=kms as we did above):

docker logs kms

You also may want to follow the logs in real time, you can achieve that with -f (or --follow):

docker logs -f kms

Health-check

To use health-check outside container make a HTTP request to health-check endpoint (/healthz) on health-check port (9092 by default). It will return check results in the JSON format and 200/503 HTTP status code.

Environment variables

KMS_TURN_URL

URL of TURN server to be used by Kurento.

Default: empty

KMS_STUN_IP and KMS_STUN_PORT

IP address and port of STUN server to be used by Kurento.

Default: empty

KMS_HEALTHCHECK_PORT

Port to health-check endpoint on.

Default: 9092

GST_DEBUG

Can be used to set the debug level of Kurento logs.

Default: 3,Kurento*:3,kms*:3,sdp*:3,webrtc*:4,*rtpendpoint:4,rtp*handler:4,rtpsynchronizer:4,agnosticbin:4

Image versions

X

Latest version of major X Kurento branch.

X.Y

Latest version of minor X.Y Kurento branch.

X.Y.Z

Latest build of concrete X.Y.Z version of Kurento.

X.Y.Z-rN

Concrete N build of concrete X.Y.Z version of Kurento.

License

Kurento itself is licensed under Apache 2.0 license.

Kurento Docker image is licensed under MIT license.

Issues

We can't notice comments in the DockerHub so don't use them for reporting issue or asking question.

If you have any problems with or questions about this image, please contact us through a GitHub issue.