Plex media server allows you to aggregate all your personal media and access it anywhere you go.

Initial Setup

First you must connect to your slot via ssh. If you need help connecting to the server, please read the help article here.

Installing Plex on your slot is easy. Simply issue the following command:

sudo box install plex

Automatic claiming

As of v1.6.0, swizzin now supports claiming your server during the installation. When you install Plex, you'll be greeted by the prompt:

Please visit, login, copy your plex claim token to your clipboard and paste it here. This will automatically claim your server! Otherwise, you can leave this blank and to tunnel to the port instead.

Simply visit the link to grab your claim code and paste it into the terminal. After Plex is installed, the script will use the claim code to grab a valid token for your user and apply it to your server.

If for some reason you didn't claim during installation, you can still run the command manually from SSH.

First we must source the Plex functions called during installation:

. /etc/swizzin/sources/functions/plex

Then we can call the function directly:

claim=<your code>
claimPlex ${claim}

The function will run and if all goes well, you'll receive a success message stating that your server as been claimed under your account.

Manual claiming

After installation, you'll need to create an SSH Tunnel to your server to appear as if you're using the same network as your Plex instance.

If you've gotten this far, I'll assume you don't need any reminders on how to connect to the server via SSH ;) However, creating an SSH tunnel takes a bit more effort than simply creating an SSH Connection.

  1. Open a command prompt or terminal
  2. Enter the command: ssh -L 8888:localhost:plexport
  3. Open your browser window and navigate to http://localhost:8888/web
  4. The browser will connect to your Plex server and let you know that there is an unclaimed server on your network.

Service Management

The systemd service file resides at:


It is not recommended to make edits directly to this file. If you must, please use an override (i.e. systemctl edit plexmediaserver)

sudo systemctl start plexmediaserver

Connect to other clients

If you need to link your Plex instance to another application, such as Sonarr or Tautulli, you can use the following details:

Port: <your plex port>