[Tutorial] How to install UMS in Docker
Posted: Mon Oct 23, 2023 4:42 am
Here is a tutorial on how I installed UMS in Docker on Ubuntu 22.04 at the time of this posting. Full disclosure I'm a newbie at linux and docker. However, even if you are experienced there a several pitfalls that need to be overcome.
For reference I used this post as a starting point that explained some of the issues.
viewtopic.php?t=12922&sid=174b29121adbb ... a12759b2c7
Basically the current UMS Docker image has several issues that we must work around.
Let's go!
First you need to find that network interface of the host computer that you will be installing UMS on. This will be typically your wifi or lan interface. WARNING!!!!! If you install UMS when you are on Wifi than plug your computer into a LAN port (or visa versa) you will have to make changes to your UMS.config file and restart your container.
Step 1:
Use the following command in terminal to find your current network interface. Make note of it for later.
Step 2:
Create a folder where you want install UMS
Step 3:
Create a docker-compose.xml file and place the below code into it and save in the UMS directory that you created in Step 2.
Step 4:
Edit your docker-compose.xml file. Change the path for the /profile to your where you placed your ums folder. All add all of the paths to your media here. The Docker UMS GUI has issues of browsing and finding media paths. The "MediaX" folders can be named anything you want. (For ex. Music, Movies, etc)
Step 5:
In terminal, navigate to your ums folder where you put the docker-compose.xml file.
Run the command
When finished docker UMS should be up and running but WAIT!!!!!!!! There is more configuration to do. There now should be a UMS.conf file in your ums folder.
Step 6:
Edit the UMS.conf file and add the line below. Insert your network interface name from Step 1 and save file.
network_interface=<insert your network interface name>
Step 7:
Restart the UMS Docker container.
Step 8:
Open up a browser window and navigate to http://localhost:9001 to view the UMS GUI
Step 9:
Create your login info
Step 10:
Using the menu bar (upper right corner) navigate to Shared Content
Step 11:
Delete the two default directories.
Step 12:
Add your Media folders that you mapped in your docker-compose.xml file.
Step 13:
Use UMS as normal. Scan your media and you should be good to go!
Good luck!
For reference I used this post as a starting point that explained some of the issues.
viewtopic.php?t=12922&sid=174b29121adbb ... a12759b2c7
Basically the current UMS Docker image has several issues that we must work around.
Let's go!
First you need to find that network interface of the host computer that you will be installing UMS on. This will be typically your wifi or lan interface. WARNING!!!!! If you install UMS when you are on Wifi than plug your computer into a LAN port (or visa versa) you will have to make changes to your UMS.config file and restart your container.
Step 1:
Use the following command in terminal to find your current network interface. Make note of it for later.
Code: Select all
ip route get 1.1.1.1 |grep -oP 'dev\s+\K[^ ]+'
Step 2:
Create a folder where you want install UMS
Step 3:
Create a docker-compose.xml file and place the below code into it and save in the UMS directory that you created in Step 2.
Code: Select all
version: '3.7'
services:
universalmediaserver:
image: universalmediaserver/ums
container_name: UMS
network_mode: host
environment:
- UMS_PROFILE=/profile
volumes:
- /path/to/your/ums folder/UMS.conf:/profile
- /path/to/media1/:/Media1:ro
- /path/to/media2/:/Media2:ro
restart: 'unless-stopped'
Step 4:
Edit your docker-compose.xml file. Change the path for the /profile to your where you placed your ums folder. All add all of the paths to your media here. The Docker UMS GUI has issues of browsing and finding media paths. The "MediaX" folders can be named anything you want. (For ex. Music, Movies, etc)
Step 5:
In terminal, navigate to your ums folder where you put the docker-compose.xml file.
Run the command
Code: Select all
docker compose up -d
Step 6:
Edit the UMS.conf file and add the line below. Insert your network interface name from Step 1 and save file.
network_interface=<insert your network interface name>
Step 7:
Restart the UMS Docker container.
Step 8:
Open up a browser window and navigate to http://localhost:9001 to view the UMS GUI
Step 9:
Create your login info
Step 10:
Using the menu bar (upper right corner) navigate to Shared Content
Step 11:
Delete the two default directories.
Step 12:
Add your Media folders that you mapped in your docker-compose.xml file.
Step 13:
Use UMS as normal. Scan your media and you should be good to go!
Good luck!