Run WatchMyMedia on Unraid
The server runs as a Docker container on your Unraid box, reading your Movies and TV shares and converting video on its GPU. Ten minutes, all of it on Unraid's own pages.
You'll need
- Unraid 6.12 or later with Docker turned on (Settings › Docker).
- Shares with your movies and TV shows, named however you like, and a cache pool for appdata.
- For converting video on the GPU: an Intel or AMD GPU, or an NVIDIA card with the Nvidia Driver plugin from Community Applications. Without one, the server converts on the CPU.
-
Install it from Apps
Open the Apps tab, search for WatchMyMedia, and click Install on its tile. Unraid opens the container's form, filled in from WatchMyMedia's template; the next two steps say what to change.
To read the listing before you install, it's on the web too: WatchMyMedia in Community Applications (opens in a new tab).
If the Apps tab offers to install Community Applications first, click Install, wait until it finishes and refresh the page.
Can't use Apps? Add the template by hand instead: open the Unraid terminal (the >_ icon at the top right), paste this line and press Return.
wget -O /boot/config/plugins/dockerMan/templates-user/my-WatchMyMedia.xml https://raw.githubusercontent.com/WatchMyMedia/unraid-templates/main/templates/watchmymedia.xmlThen open Docker, click Add Container at the bottom, and choose WatchMyMedia from the Template list. The form is the same.
-
Point it at your shares
Change the paths that don't match your shares. The container reads your media read-only; it cannot change or delete anything there.
- MoviesYour movies share, such as
/mnt/user/Movies. It becomes a library the first time the server starts. - TV ShowsYour TV share. No TV shows? Point it at an empty folder.
- RecordingsWhere live TV recordings go, if you have an HDHomeRun tuner. Remove the entry if you don't.
- AppdataUnder Show more settings: the database, settings and artwork, on
/mnt/user/appdata/watchmymedia. Keep appdata on a cache pool, as Unraid recommends. - Network TypeLeave Host: that is how your TVs and phones find the server by name and how Chromecast reaches it.
Leave PUID and PGID at 99 and 100 (Unraid's
nobodyandusers) unless your shares need another user. - MoviesYour movies share, such as
-
Give it your GPU
Intel or AMD
Nothing to do: the template passes
/dev/drito the container, and the server gives itself the right to use it. If your server has no GPU at all, remove the Intel or AMD GPU entry, or the container won't start.NVIDIA
Install the Nvidia Driver plugin from Community Applications if you haven't, and restart. Then, with Advanced View on (top right of the form), type
--runtime=nvidiainto Extra Parameters, and put your card's UUID from the plugin's page (it starts withGPU-) into NVIDIA_VISIBLE_DEVICES. Leave NVIDIA_DRIVER_CAPABILITIES asall. -
Start it and finish setup
Click Apply. Unraid pulls the image and starts the container; when its icon shows a green play mark, click it and choose WebUI. Setup opens: create your account and check the libraries it found. Follow Set up your server for posters and the rest.
To see which encoder the server found, open Settings › Transcoding in WatchMyMedia. Its Encoder section names the one in use (Quick Sync or VAAPI for Intel and AMD, NVENC for NVIDIA), whether it passed its test, and whether new plays can convert up to 4K. If the server fell back to software, a banner says so, with Test again and Choose another.
-
Keep it updated
New versions arrive as a new image. On Unraid's Docker page, click Check for Updates; when WatchMyMedia shows update ready, click it and apply. Your library, settings and artwork stay in appdata. WatchMyMedia's own Check for updates, under Settings › General, says whether a newer version is out.
Back up first with Back up now under Settings › Backups: 2.0.0 changes the server's database, and going back to an older image afterwards needs a backup made before the update.
You're done when the Docker page shows WatchMyMedia running and its WebUI opens your library.
Good to know
-
Converting in RAM. Converted video is written to appdata while it plays. To keep it in memory instead, remove the
Transcode path and add
--mount type=tmpfs,to Extra Parameters. Set the size to what you can spare: a 4K film's conversion can run to several gigabytes.destination=/transcode, tmpfs-size=4g -
Bridge networking works too, with port 27587 mapped, but TVs and phones then need the address typed in, and casting
needs
WATCHMYMEDIA_CAST_URLset to an address TVs can reach. - Watching away from home goes through a reverse proxy such as SWAG or Nginx Proxy Manager from Community Applications, with HTTPS. Don't put the proxy's own login in front: WatchMyMedia has its own sign-in, and the TV apps can't get past another.
If it doesn't work
Written for WatchMyMedia 1.4.7 on November 16, 2026. Installing from Apps was rewritten on November 19 and 20, 2026, for Community Applications, and Keep it updated gained the 2.0.0 backup note on November 21, 2026. Not yet followed step by step on an Unraid server.