Plex

Plex lets you stream your media anywhere, on any device.

We provide support for running a full instance (as opposed to shared) Plex Media Server on a slot. The server has access to all of your media and enables streaming to other devices.

Installation

To set up Plex Media Server on your slot, please do the following:

  1. Sign up to www.plex.tv.
  2. Create and place your username and password in the file ~/private/plex.login with the format username:password (that is, your username and password on one line separated by a colon). Replace username with your plex.tv username or e-mail and password with your plex.tv password.
  3. Wait 5 minutes for the system to check and begin the installation.
  4. Once processed plex.login will be removed (regardless of a successful install).
  5. If the configuration was successful, the file ~/private/plex.url and folder ~/private/plex will be created.

Finally, visit the URL found in ~/private/plex.url in your browser to use Plex. You should not put any media inside the ~/private/plex as updating involves deleting it; instead, use a different location.

Starting, stopping and restarting Plex

To start or restart Plex, make sure no instances are running (by stopping Plex) and wait 5 minutes. Starting Plex requires special handling and so cannot be started directly.

To stop Plex, run the following SSH command:

pkill -9 -fu "$(whoami)" 'plexmediaserver'
pkill -9 -fu "$(whoami)" 'EAE Service'

Using Plex

For help using the software itself you should consult Plex's own support page first of all as it's likely that your question is covered there. This section will cover anything specific to Plex on Feral.

Updating Plex

Feral's installation will use the same version each time. The idea behind this is that more Feral users will use it making it more certain that it will run correctly on all of our servers regardless of the condition. This emphasises server stability over newer features.

To install the Feral version delete the ~/private/plex folder then create it again and wait 5 minutes. This can be completed with the SSH command rm -r ~/private/plex; mkdir ~/private/plex.

Installing a specific version

You can override the Feral version retrieved by deleting then creating the Plex folder ~/private/plex and putting the specific version in the file ~/private/plex/.version. The system will then attempt to install this specific version. After the installation attempt the .version file will be removed. The following command will install a specific version:

rm -r ~/private/plex
mkdir ~/private/plex
echo requested-version >~/private/plex/.version

You will need to replace requested-version with a valid version string. The latest version string can be found on Plex's download page, selecing Download from the first step then selecting Computer > Linux from the Choose your platform drop-down box and finally using the string beneath Plex Media Server for Linux. It will look something like 1.12.1.4885-1046ba85f.

Troubleshooting

Plex does not install after 5 minutes

If you've created the file ~/private/plex.login then it will disappear once the installation process sees it. If it disappears and you do not see ~/private/plex then you can assume it was not successful (i.e., an incorrect password).

You should double check your username / password works by logging into Plex.tv

Plex doesn't start up after 5 minutes

After checking that ~/private/plex exists, you should check whether any old Plex processes are running. The system is "naive" in that it checks for any process with "Plex" in the command-line. To see all "Plex" processes run the SSH command ps x | grep Plex | grep -v grep. Stopping all Plex processes will allow it to be restarted properly.

Uninstalling

The SSH command below will completely remove Plex binaries and its configuration.

pkill -9 -fu "$(whoami)" 'plexmediaserver'; pkill -9 -fu "$(whoami)" 'EAE Service'
rm -r ~/private/plex ~/Library
grep -l 32400 ~/.config/feral/ns/forwarding/tcp/* | xargs rm

External links