2025-04-02 20:07:51 +02:00

166 lines
5.2 KiB
Markdown

---
title: "Plex"
date: 2023-01-23T13:59:59-03:00
draft: false
weight: 9
summary: Plex is a media streaming platform that organizes your personal media library and lets you stream it anywhere, plus access live TV, movies, and shows.
---
# What is Plex?
From their [website](https://www.plex.tv/):
> With our free app you can add, access, and share all the entertainment that matters to you, on almost any device—including your own personal media collection. Guess that makes us the hardest working app in show business.
In YAMS, Plex is going to be your streaming service powerhouse! 🌟 It's like having your own Netflix, but with way more control. Plus, sharing with friends and family is super easy!
**Note:** Be warned that Plex has [recently](https://www.plex.tv/blog/important-2025-plex-updates/) put its most basic features behind a monthly subscription or a single lifetime purchase.
## First steps
Before we dive in, we need to do a bit of setup magic to let Plex work its charms. First, stop YAMS:
```bash
$ yams stop
```
Now, let's allow your IP range to access Plex. Head to your Plex config folder (I'm assuming your install location is `/opt/yams` - adjust if you used a different path):
```bash
$ cd /opt/yams/config/plex/Library/Application\ Support/Plex\ Media\ Server/
```
Inside that folder, we need to edit `Preferences.xml`:
```bash
$ vim Preferences.xml
```
(Don't worry if you're not a vim fan - `nano` works just fine too! 😉)
Add this line right after the `<Preferences` part:
```xml
<Preferences allowedNetworks="<your_subnet_IP>/255.255.255.0" ...
```
The `...` means "leave the rest of the file as is" - we're just adding the `allowedNetworks` bit.
### How do you find your subnet IP? 🤔
It usually follows these patterns:
- If your server IP is `192.168.0.100`, your subnet is `192.168.0.0`
- If your server IP is `10.0.0.25`, your subnet is `10.0.0.0`
Time to restart YAMS:
```bash
$ yams restart
```
Let's check if everything's working:
```bash
$ docker logs plex
```
If you see something like:
```bash
Failed to load preferences at /config/Library/Application Support/Plex Media Server/Preferences.xml
Failed to load preferences at /config/Library/Application Support/Plex Media Server/Preferences.xml
```
It means your `Preferences.xml` needs some fixing - double-check the format and try again!
**Note:** Want to learn more about this setup? Check out this [TrueNAS community thread](https://www.truenas.com/community/threads/plex-not-authorized-you-do-not-have-access-to-this-server.96858/).
## Initial configuration
In your browser, go to [http://{your-ip-address}:32400/web]() and you'll see Plex's setup page. Click "Got it!" to get started.
**Important Note:** Unlike other YAMS services, Plex requires the "/web" path after the port number. If you just go to port 32400 without "/web", you'll see an XML file instead of the web interface.
[![plex-1](/pics/plex-1.png)](/pics/plex-1.png)
After logging in, you'll see a "Plex Pass" modal. You can close that for now - we'll get to the good stuff!
[![plex-2](/pics/plex-2.png)](/pics/plex-2.png)
Give your server a name and click "Next".
[![plex-3](/pics/plex-3.png)](/pics/plex-3.png)
For "Sync Your Watch State and Ratings", just click "No" - keeping things simple!
[![plex-4](/pics/plex-4.png)](/pics/plex-4.png)
Time to add our media! Click "Add Library" on the "Media Library" screen.
[![plex-5](/pics/plex-5.png)](/pics/plex-5.png)
### Adding Movies
Pick "Movies" as your library type and click "Next".
[![plex-6](/pics/plex-6.png)](/pics/plex-6.png)
Click "Browse For Media Folder".
[![plex-7](/pics/plex-7.png)](/pics/plex-7.png)
Choose the movies path (`/data/movies`) and click "Add".
[![plex-8](/pics/plex-8.png)](/pics/plex-8.png)
Your screen should look like this. Click "Add Library" to finish up!
[![plex-9](/pics/plex-9.png)](/pics/plex-9.png)
### Adding TV Shows
Back in "Media Library", click "Add Library" again.
[![plex-10](/pics/plex-10.png)](/pics/plex-10.png)
This time pick "TV Shows" and click "Next".
[![plex-11](/pics/plex-11.png)](/pics/plex-11.png)
Click "Browse For Media Folder" again.
[![plex-7](/pics/plex-7.png)](/pics/plex-7.png)
Choose the TV Shows path (`/data/tvshows`) and click "Add".
[![plex-12](/pics/plex-12.png)](/pics/plex-12.png)
Looking good? Click "Add Library"!
[![plex-13](/pics/plex-13.png)](/pics/plex-13.png)
Your "Media Library" screen should now show both libraries. Click "Next" to continue.
[![plex-14](/pics/plex-14.png)](/pics/plex-14.png)
## Finishing up
Almost there! Click "Done" on the finish screen.
[![plex-15](/pics/plex-15.png)](/pics/plex-15.png)
Welcome to your Plex dashboard! 🎉 Click on "More" in the left side panel.
[![plex-16](/pics/plex-16.png)](/pics/plex-16.png)
There they are - your local "Movies" and "TV Shows" libraries!
[![plex-17](/pics/plex-17.png)](/pics/plex-17.png)
## That's all folks! 🎬
YAMS is fully up and running! Ready to add some content? Head over to [Running everything together](/config/running-everything-together)!
## Want to become a Plex power user? 💪
If you want to really dive into what Plex can do, check out the [TRaSH Guide for Plex](https://trash-guides.info/Plex/). They've got some amazing advanced configurations in there!