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.

  1. 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:ro

    Change four things:

    • /path/to/Movies and /path/to/TV: your own folders. :ro lets the server read them and never write to them. With only movies, point /tv at an empty folder, or the reverse.
    • PUID and PGID: the user and group that can read those folders. id -u and id -g print yours.
    • TZ: your time zone, such as Europe/London.

    ./config holds the library's database, artwork and backups, and ./transcode holds video while it's being converted. Both are made beside the file the first time the server starts.

    network_mode: host lets 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"
  2. Start it

    In that folder:

    docker compose up -d

    Docker 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 as http://192.168.1.20:27587.

  3. Set it up in the browser

    Setup opens: create your account and add a free TMDB key for posters. Your folders are /movies and /tv inside 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.