Run WatchMyMedia with Docker
The same server as the Mac and Windows apps, as a container on a Linux computer or a NAS that's already on all day. One file and one command, typed in a terminal.
You'll need
- A Linux computer or NAS with Docker and Docker Compose, on an Intel or AMD (x86-64) or ARM64 processor.
- Your movies and TV shows in folders that computer can read, with movies and TV shows in separate folders.
- A terminal on that computer, or SSH into it.
On a Mac or a Windows PC, install the app instead: it needs no Docker, and Docker on a Mac can't use the Mac's graphics hardware. On Debian or Ubuntu and on Fedora, a package runs the server without Docker and updates with the system. On Unraid, install it from Community Applications.
-
Write the compose file
Make a folder for the server, and in it a file called
compose.yaml:services: watchmymedia: image: ghcr.io/watchmymedia/watchmymedia:latest container_name: watchmymedia restart: unless-stopped network_mode: host environment: PUID: "1000" PGID: "1000" TZ: "America/New_York" volumes: - ./config:/config - ./transcode:/transcode - /path/to/Movies:/movies:ro - /path/to/TV:/tv:roChange four things:
/path/to/Moviesand/path/to/TV: your own folders.:rolets the server read them and never write to them. With only movies, point/tvat an empty folder, or the reverse.PUIDandPGID: the user and group that can read those folders.id -uandid -gprint yours.TZ: your time zone, such asEurope/London.
./configholds the library's database, artwork and backups, and./transcodeholds video while it's being converted. Both are made beside the file the first time the server starts.network_mode: hostlets the phone and TV apps find the server by name on your home network. If you'd rather not use it, replace that line with these two, and type the server's address into the apps once:ports: - "27587:27587" -
Start it
In that folder:
docker compose up -dDocker downloads the image and starts the server, and starts it again whenever the computer restarts. Then, from a browser on the same home network, open
http://, the computer's address and:27587, such ashttp://192.168.1.20:27587. -
Set it up in the browser
Setup opens: create your account and add a free TMDB key for posters. Your folders are
/moviesand/tvinside the container, and each is added as a library on the first start if it holds anything. Set up your server goes through every step.
You're done when docker compose ps shows watchmymedia running and healthy, and the browser opens your library.
Convert video on the GPU
Without a GPU the server converts video on the processor, which works but is slower. The image carries the Intel, AMD and NVIDIA drivers, so the container only has to be handed the GPU.
Intel or AMD
Add these lines under watchmymedia:, then run docker compose up -d again:
devices:
- /dev/dri:/dev/dri
NVIDIA
Install the NVIDIA Container Toolkit
on the computer, then add runtime: nvidia under watchmymedia: and
NVIDIA_VISIBLE_DEVICES: all under environment:.
Settings › Transcoding in the web app shows which encoder the server found. For Intel and AMD,
docker exec watchmymedia vainfo lists what the driver can do.
Update it
Check for updates, under Settings › General, says when a newer version is out. Back up first with
Back up now under Settings › Backups: 2.0.0 changes the server's database. Then, in the folder with
compose.yaml:
docker compose pull
docker compose up -d
Your library, settings and artwork stay in ./config. To stay on one version, replace latest in the
file with its number, such as 2.0.0. Going back to an older number after an update that changed the database needs
the backup you made before it. Updates and backups covers backups.
Linux without Docker
On Debian and Ubuntu and on Fedora, install the package: it runs the server as a system service and updates with the system. Install on Debian or Ubuntu and Install on Fedora have the steps.
For other distributions, each release on GitHub also has the server as an archive for Linux, for x86-64 and ARM64, with the FFmpeg it uses beside it. Unpack the archive into a folder of its own and run the program in it with a folder for its data:
WATCHMYMEDIA_DATA_DIR=~/watchmymedia ./watchmymedia-v2.0.0-linux-amd64
Then open http://localhost:27587. The archives of 1.6.1 and earlier hold only the server, and need FFmpeg
installed. Nothing starts the plain program for you after a restart, and it uses the GPU through your system's own drivers;
the Docker image carries the Intel and AMD drivers itself.
If it doesn't work
Written for WatchMyMedia 1.4.5 on November 14, 2026. The compose file was run with the published image and port 27587 published; host networking, GPU conversion and the plain Linux program were not tried for this page. Linux without Docker was rewritten on November 18, 2026, for WatchMyMedia 1.7.0, the first release with the packages and the first whose Linux archive holds FFmpeg. The versions in the examples and the backup before updating were changed for 2.0.0 on November 21, 2026.