Skip to content


Docker Pulls GitHub Stars


Plex organizes video, music and photos from personal media libraries and streams them to smart TVs, streaming boxes and mobile devices. This container is packaged as a standalone Plex Media Server. has always been a top priority. Straightforward design and bulk actions mean getting things done faster.

Common Error: "Cannot Claim Server on First Run"

If you are starting the Plex container for the first time and cannot claim your server to set it up there are 3 methods you can try to resolve the issue:

1. Set the PLEX_CLAIM variable

docker stop plex
docker rm plex
# removes the config folder for plex
# !WARNING! do NOT do this if you have already setup your plex server and are having issues connecting to it, skip to option 3 instead
rm -rf ~/.config/appdata/plex
sudo nano ~/.docker/compose/.env
# with the nano file editor open locate the PLEX_CLAIM variable
# go to in your browser and get the claim token set your PLEX_CLAIM variable
# the token expires in 5 minutes, so we'll want to get the rest done quickly
# ctrl+x to save and exit nano
ds -c up plex

Then try again to claim the server by visiting http://yourserverip:32400/web/index.html

2. Host Network Mode

If the first method does not work, edit your .env and set PLEX_NETWORK_MODE=host. Run ds -c and then attempt to claim your server. After claiming your server set PLEX_NETWORK_MODE= (back to blank).

3. Claim helper script

If the first and second methods both have not worked this script should make it happen.

docker exec -it plex /bin/bash
# download the script
curl -L -o
# make the script executable
chmod +x
# go to in your browser and get the claim token and replace PLEX_CLAIM with this token in the next command, please use use the double quotes around your claim token
# fix permissions
chown abc:abc "/config/Library/Application Support/Plex Media Server/Preferences.xml"
# leave the container
docker restart plex

How To Run Plex Different Pass Versions

Edit ~/.docker/compose/.env and set:


Then run:

ds -c up plex

Rebuilding From Scratch

Thankfully, some of this information is well documented (but not easily found) over on Plex's website here!

  1. Moving an installation to another system:
  2. Where is the Plex Media Server data directory?

Hardware Transcoding

If you would like to have Plex use a GPU that is attached to your DockSTARTer host, you can do this using an override like so:

      - /dev/dri:/dev/dri

Refer to this forum post for details: Using Hardware Acceleration in Docker