Skip to content

Plex in Docker on a Synology NAS (Hardware Transcoding)

Last updated on 30 November 2023

Please note if you are using DSM7.2 or higher you should use the Container Manager version of this guide from the menu.
This guide has reached the end of its updates as most people are now on the latest DSM update - This guide is correct as of 08/12/2023 however no further updates will be added.
UpdateDate
Amended the path to save the compose file – this is for security, so the container has no access to the file contents.14/04/2023
Historic updates now at the end of the guide.

In this guide I am going to take you through the setup of Plex in Docker using Docker Compose.

As of writing the Synology UI does not have the capability of passing through specific hardware to a container, this means we will need to set up Plex via SSH (terminal). However, don’t freak out as it’s not that difficult!

Plex Pass

You will only benefit from hardware transcoding if you have an active Plex Pass either monthly or lifetime. If you don’t have one you can either follow this guide or jump over to the non hardware transcoding version.

Does my Synology support Hardware Transcoding?

Before we do anything else, you need to make sure your model of Synology has hardware transcoding capabilities. You need to do a quick lookup via the linked Google Sheet below, this is updated by Plex and makes it super easy to look up your model of NAS.

If you find that hardware transcoding is not available on your model you can jump back over to the standard guide here

Let’s Begin

As usual, it’s important you complete the two proceeding guides which will get your folder structure and docker, user setup.

Docker Compose

We will be using Docker Compose to set up the Plex container. In a nutshell we will be creating a text file (YAML formatted) which tells Docker exactly how we want to set up a specific container.

The next steps can be done either using a code/text editor such as Notepad++ or to keep things simple for this guide we will be using the Synology Text Editor which can be installed from the Package Center.

Install Text Editor from the Package Center

Open up Text Editor and click on File then New to start a new file.

You can now copy and paste the details below into the new text file, it is important you don’t change the spacing as YAML has to be formatted correctly in order to be read by Docker Compose.

YAML
services:
  plex:
    image: linuxserver/plex
    container_name: plex
    network_mode: host
    environment:
      - PUID=1234 #CHANGE_TO_YOUR_UID
      - PGID=65432 #CHANGE_TO_YOUR_GID
      - TZ=Europe/London #CHANGE_TO_YOUR_TZ
      - VERSION=latest
      - PLEX_CLAIM=
    volumes:
      - /volume1/docker/plex:/config
      - /volume1/data/media:/data/media
    devices:
      - /dev/dri:/dev/dri
    restart: unless-stopped

A note on Network Mode

You will notice that for Plex we don’t put it on the normal bridge network, this is because DSM reserves the DLNA ports Plex requires in order to use DLNA. So we run in Host mode, so it can share the ports.

Environment Variables

We need to make some changes in order for the container to have the correct permissions to save its configuration files and to have access to your media.

Please note the PLEX_CLAIM variable is optional and not always required. You can remove this line if you don’t need it or come back and add it if you are unable to sign in to your server on start up.

To get the code go to https://plex.tv/claim and sign in, then put the code you receive after the ‘PLEX_CLAIM=’. You have 4 mins to finish the guide after doing this, so best to grab it just before running the compose file in a few steps time.

PUID and PGID

When you created your docker user you would have noted down these IDs add these to the compose file in the ‘environment:’ section

Volumes

We can now pass through our file paths into the container they are mounted using the volume’s section of the compose file.

I have pre-filled this section to pass the correct paths, the only thing that you may need to change is the /volume1/ if your file paths are on a different volume.

Timezone

The timezone variable will tell the container where you are in the world meaning your logs and scheduled tasks will run at the correct times. A list of timezones with the correct formatting can be found here wikipedia.org/wiki/List_of_tz_database_time_zones

Your final file should look similar to the one shown below.

Saving the Compose File

We now need to save this file into our docker share.

Click on File then Save As, navigate to the ‘Docker’ share and create a new folder called ‘plex’ (lower case)

You need to change the ‘File name’ to plex.yml and save it in the ‘docker‘ folder

SSH and Docker-Compose

It’s time to get logged into your Diskstation via SSH, you can do this in the same way as when you obtained your IDs in the ‘Setting up a restricted Docker user‘ guide.

Once you have logged in you will need to give 2 commands, you can copy and paste these one at a time — you will need to enter your password for the command starting with ‘sudo’

First we are going to change directory to where the plex.yml is located, type the below and then press enter.

Bash
cd /volume1/docker

Then we are going to instruct Docker Compose to read the file we created and complete the set-up of the container. Again type the below and press enter.

Bash
sudo docker-compose -f plex.yml up -d

When the command has completed you should be able to see Plex running in the list of containers in the Synology GUI.

Plex Initial Setup

After a few minutes you should be able to access the server and go through the Plex setup by going to the IP of your NAS in your browser followed by port 32400/web/

e.g 192.168.0.45:32400/web/

You will be asked to sign in or sign up for an account if you don’t have one already.

You should now be able to add your media which will be in the /data/media folder within Plex

Once you have got to the main Plex interface make sure you go into the settings and turn on

  • Enable HDR tone mapping
  • Use hardware acceleration when available

That’s it you are all setup. When a new server update is available you will just need to restart the container, and it will automatically download the latest update.

Historic UpdatesDate
New guide released06/12/2021
Added note around Ryzen based Synology models27/12/2021
Updated Environment Variables to ensure server is updating to the latest version02/02/2022
Added Timezone Variable to the compose file22/05/2022
Amended the mount path for media12/08/2022
Amended the Plex image to pull from dockerhub to make updates easier18/08/2022
Updated the Hardware Transcode section it’s now much easier02/09/2022
Added the Optional Plex Claim to the Environment Variables18/02/2023
Compose version number removed and small wording amendments09/04/2023
Historic Updates

Buy Me a Coffee or a Beer

If you have found my site useful please consider pinging me a tip as it helps cover the cost of running things or just lets me get the odd beverage. Plus 10% goes to the devs of the apps I do guides for every year.

Published inPlex 7.1

147 Comments

  1. Stov Stov

    Heya, quick question on why this setup uses network_mode: host vs. the bridge created in the initial setup guide (synobridge) like some of the other containers do?

    • Dr_Frankenstein Dr_Frankenstein

      Hey, I was going to move over to the bridge however Plex recommend running this in host mode, also on the non hardware guide when doing the setup via the UI DSM seems t reserve port 1900 which stops you using it.

  2. Hi, I followed the guide, but for me HW transcoding isn’t working. I do have the /dev/dri/ folder, but when I transcode, it uses SW transcoding.

    I’ve enabled the settings in Plex. The only things I did not do are:
    Step 1: Directory Setup Guide
    Step 2: Setting up a restricted Docker user

    I have existing directories which I use. That seems to work.
    I did not set up da restricted docker user, I run everything under my own account, is that a problem?

  3. Why aren’t you consistent with your paths ?
    I would recommend to change the paths from:
    /volume1/data/media:/media to /volume1/data/media:/data/media

    • Dr_Frankenstein Dr_Frankenstein

      Hey Trash thanks for checking in, I honestly didn’t think it mattered for Plex itself due to it being the tail end of the chain. I trust that it does so will make the tweak on this and the other Plex guide.

      Scrub what I said previously above! – I am not sure why I used this path in here and the /data mount path in the other guide. I have aligned them both now!

    • Dr_Frankenstein Dr_Frankenstein

      They are the same images just linuxserver recommend pulling from their repository in Docker Compose.

  4. Sid Sid

    Plex says “Not authorized, You do not have access to this server” when I run it for the first time. I followed all instructions. Any tips?

    • Sid Sid

      Resolved that part, now it won’t allow me to add media from the nas. Giving an option of get media server link. I guess that’s a plex issue rather than a technical install issue?

      • Dr_Frankenstein Dr_Frankenstein

        Hey Sid, sounds like a Plex setup error. Are you able to jump on Discord or use the contact page (top left under the logo) to send a screenshot over?

    • Dr_Frankenstein Dr_Frankenstein

      Hey – Did you get everything resolved, just catching up on comments

Leave a Reply to Sid Cancel reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.

drfrankenstein.co.uk – writing Synology Docker Guides since 2016 – Join My Discord!