Our search function may intermittently fail to display results. If this happens, try refreshing the page, as this usually resolves the issue. We’re working on a permanent fix. Thank you for your patience!
Plex
Plex Media Server is a proprietary media player suite that organizes video, audio, and photos from a user's media collection and online services. The user can access and stream the content from the server to any device where Plex is offered.
More information can be found here.
In this section, we will be detailing the initial configuration of your Plex Media Server. This assumes that you have stored your media in ~/media. Our Plex installation automatically creates your media folders inside ~/media as follows:
~/media/Movies~/media/TV Shows~/media/Music
No further step needed, although if you would want to change your library paths in Plex, you can read a guide about it here.
Prerequisites
- A Plex account - you can create one here.
- An Ultra plan that supports media servers (any except Essential tier)
Initial UCP Configuration
Like all applications, Plex Media Server can be installed from the UCP, this application, however, has one extra step. When you click on Install and are prompted with this screen, you will need to visit plex.tv/claim.
If you have not done so already, sign in to your Plex account and copy the claim code provided. Paste this into the prompt and then click Install.
Your Plex Media Server comes configured out of the box. Just connect to your Plex Media Server instance by following the link in the UCP - as is typical with all official applications.
Plex Plugin Installers
Listed below are scripts that install some popular plugins into your Plex Media Server instance. To install a plugin, connect to your Ultra service via SSH and execute the provided command for the plugin you would want to install. Some post-installation notes are detailed for each plugin.
Absolute Series Scanner/Hama Bundle
curl https://scripts.ultra.cc/main/Plex/Plex-Plugins/hama-ass.sh | bashPost Installation:
- More info here: https://github.com/ZeroQI/Hama.bundle
Extended Personal Media Shows
curl https://scripts.ultra.cc/main/Plex/Plex-Plugins/epms.sh | bashPost Installation:
- More info here: https://bitbucket.org/mjarends/extendedpersonalmedia-agent.bundle/src/master/README.md
Trakt.tv Scrobbler
curl https://scripts.ultra.cc/main/Plex/Plex-Plugins/trakt.sh | bashPost Installation:
- More info here: https://github.com/trakt/Plex-Trakt-Scrobbler
Get SSL-URL for Plex Media Server
- This can be useful if you wish to connect to Plex from a remote device.
- Connect to your service via SSH.
- Once connected, execute the following command:
bash <(wget -qO- https://scripts.ultra.cc/main/Plex/plex-ssl-url.sh)Troubleshooting Information
How do I update Plex?
Plex can be upgraded from the Apps tab on your User Control Panel. Simply find Plex in the list and click the green Action button to reveal a context menu. In the menu, press the Upgrade & Repair button to start the upgrade.
Please note, once the upgrade process has finished, the initial launch of your Plex instance can take a while, especially for larger media libraries. In rare cases, it can take up to an hour. We therefore do not recommend restarting the instance, or retry upgrading again, as it will reset the process back to square one.
Plex can also be upgraded to a specific version, and this is done via SSH. Instructions on how to upgrade can be found here.
My Plex is down. What are some troubleshooting steps to resolve it?
Usual causes of this are Plex updates, or the server cannot read or write to the library, which is a common occurrence with Rclone mounts. In these cases, the RAM usage of Plex would go up, and the system will kill your Plex instance.
It is also worth noting that some of Plex's features, especially logins, server claiming API, and web apps, are centrally hosted by Plex and not locally attached to your Plex Media Server. Any outage announcements will be posted here: https://status.plex.tv.
- First, try to restart Plex from the Apps tab on the UCP, and wait at least 5 minutes to see if it starts.
- Check if the container is not damaged. Try to use the upgrade/repair option from your UCP action menu under Installed tab -> Plex and wait for 5 minutes.
- Try to claim your server again, as your server token is expired. Visit https://plex.tv/claim to get your claim code. Then, use the Claim option from your UCP action menu under Installed Applications -> Plex. Paste your code and click claim.
- If Plex still is not running, log in to your Ultra service via SSH and execute the following command:
ps aux | grep [p]lex- If it returns any sort of
Dstate or<defunct>, something is holding the Plex process. - If Plex is Defunct, this is usually caused by a broken Rclone mount. To fix that, you should follow the instructions provided here, and then restart Plex. After restarting the Rclone mount and Plex, execute
ps aux | grep [p]lex, and if it returns nothing, your Plex is running normally. If not, repeat the guide. - If it is still in
Dstate, then another third-party application is holding the process. Stop any application that is affiliated with your Plex Media Server instance. - If
grepreturns normally, is not in a defunct state, but you cannot access Plex, your Plex database may be corrupted, and you may need to view the logs. You can either run the following command via SSH and look for any errors. You can also download the logs from the settings in the Plex webUI.
cat .config/plex/Library/Application\ Support/Plex\ Media\ Server/Logs/Plex\ Media\ Server.log- Any SLOW QUERY and SQLite errors/warnings are signs of a corrupted database. You may attempt to repair your database with Plex SQLite.
- If it does not work, the last resort is to back up your old configuration to confirm that your database is corrupted and see if Plex comes online with a new configuration. Execute the following commands:
mv ~/.config/plex ~/.config/plex.bak- Then afterward, reinstall Plex. If it runs, you may need to do a fresh installation of Plex.
Why is Plex producing a transcoder error?
The Plex Transcoder exited error is a general error for not playing back the media using the video player or transcoder, and you may need to view the logs. You can either run the following command on SSH and look for any errors. You can also download the logs from the settings in the Plex webUI.
cat .config/plex/Library/Application\ Support/Plex\ Media\ Server/Logs/Plex\ Media\ Server.logERROR - An error occurred reading the file
If you encounter the following error message: ERROR - ERROR - An error occurred reading the file: /home/username/SOMEMOUNT/path/to/File.mp4 (5)
Something is wrong with your Rclone mount, and it will need to be investigated separately. In this case, it is usually Error 403: Rate Limit Exceeded, rateLimitExceeded, or a completely dropped mount endpoint.
Extra Guides
Upgrade/Downgrade Plex by Specific Version
app-plex upgrade --plex-version=<versionnumber-build>- This allows you to specify any version of Plex from v1.15 onward.
- Take note that you have to put in the full version number of the build you want to install, or the command will fail.
- You can refer to Plex's Official Docker Hub Page or LinuxServer.io's Plex Docker Hub Page for the version number you want.
- For instance, if you want to install version 1.20.3.3483. After checking for the full version on the Docker Hub page, you will run the following
app-plex upgrade --plex-version=1.20.3.3483-211702a9fPlex SQLite
The Plex SQLite binary is accessible from your Ultra service, and can be useful for managing or repair a corrupted Plex database. To access the utility tool, follow the below instructions.
- Connect to your Ultra service via SSH.
- Once connected, execute the below command for usage instructions:
plex-sqlite --help- Do note, this is an advanced utility tool, make sure to read up on how it works before use. More information can be found here.
If you require further assistance, you can open a support ticket here!
Feedback and suggestions regarding this article are welcome on our Discord server
- Plex
- Prerequisites
- Initial UCP Configuration
- Plex Plugin Installers
- Absolute Series Scanner/Hama Bundle
- Extended Personal Media Shows
- Trakt.tv Scrobbler
- Get SSL-URL for Plex Media Server
- Troubleshooting Information
- How do I update Plex?
- My Plex is down. What are some troubleshooting steps to resolve it?
- Why is Plex producing a transcoder error?
- ERROR - An error occurred reading the file
- Extra Guides
- Upgrade/Downgrade Plex by Specific Version
- Plex SQLite