mbentley/ums repository overview

⁠mbentley/ums

docker image for Universal Media Server (UMS) based off of alpine:latest

To pull this image: docker pull mbentley/ums

⁠Image Tags

⁠Multi-arch Tags

⁠Archived Tags

These images are still published on Docker Hub but are no longer regularly updated due to the base OS no longer being supported or the version being older. Use with extreme caution as these images are likely to contain unpatched security vulnerabilities!

⁠Explicit Architecture Tags

These tags will explicitly pull the image for the listed architecture and are bit for bit identical to the multi-arch tags images.

⁠Permission Prerequisites

By default, UMS will run as a non-root user. Due to this, your media directory that you bind mount into the container must have other permissions set to rx:

chown -R o+rx /path/to/my/media

⁠Example usage

Default UMS.conf with a media folder specified:

docker run -d \
  --init \
  --net=host \
  --restart=always \
  --name ums \
  -e FOLDER="/media" \
  -e FORCE_CHOWN="false" \
  -e NETWORK_INTERFACE="" \
  -e LOG_LEVEL="" \
  -e PORT=5001 \
  -e SET_MEDIA_PERMISSIONS="false" \
  -v ums-data:/opt/ums/data \
  -v ums-database:/opt/ums/database \
  -v /path/to/your/media:/media \
  mbentley/ums

Custom UMS.conf and persistent UMS.cred file, data and database directories:

docker run -d \
  --init \
  --net=host \
  --restart=always \
  --name ums \
  -e FOLDER="" \
  -e FORCE_CHOWN="false" \
  -e NETWORK_INTERFACE="" \
  -e LOG_LEVEL="" \
  -e PORT=5001 \
  -e SET_MEDIA_PERMISSIONS="false" \
  -v /path/to/your/UMS.conf:/opt/ums/UMS.conf \
  -v /path/to/your/UMS.cred:/opt/ums/UMS.cred \
  -v /path/to/data:/opt/ums/data \
  -v /path/to/database:/opt/ums/database \
  -v /path/to/your/media:/media \
  mbentley/ums

⁠Environment Variables

• FOLDER - (default: null) Automatically set the path to the media folder for UMS in UMS.conf
• FORCE_CHOWN - (default: false) When set to true, forces ownership of the /opt/ums/data and /opt/ums/database directories so UMS can write to them
• NETWORK_INTERFACE - (default: null) UMS will autodetect the network interface; sometimes you want to specify which network interface to have UMS bind to
• LOG_LEVEL - (default: null) UMS defaults to INFO, can be ALL, TRACE, DEBUG, INFO, WARN, ERROR or OFF
• PORT - (default: null) Defaults to the UMS default which is currently 5001 if not set; changed the default port if set
• SET_MEDIA_PERMISSIONS - (default: false) When set to true & FOLDER passed, performs a chmod on the FOLDER directory so that it is world read/execute to be able to read the media files and traverse directories

⁠Persistent Data

Warning: Volumes for UMS.conf, data database are optional but the data in them will not persist otherwise. If you need a UMS.conf file to start from, you can start a container and use docker cp to transfer the file to your host:

docker run -d --name ums-temp mbentley/ums bash
docker cp ums-temp:/opt/ums/UMS.conf UMS.conf
docker stop ums-temp
docker rm ums-temp

Note: You will likely need to chown all persistent files and directories to 500:500. The entrypoint script will attempt to do it for you if they're not set correctly.

If you would rather not use --net=host, you can expose the ports for UMS but autodiscovery might not work:

• TCP - 2869, 5001, 9001
• UDP - 1900