Plex-Meta-Manager/docs/home/guides/unraid.md

49 lines
3.6 KiB
Markdown
Raw Normal View History

2022-03-08 08:06:22 +00:00
# unRAID Walkthrough
Thankfully, getting Plex Meta Manager working on unRAID is a fairly simple task. unRAID works mostly with docker containers, so the pre-built container available on docker hub works perfectly with a little configuration.
To install a container from docker hub, you will need community applications - a very popular plugin for unRAID servers. If you don't already have this installed, you can install it [here](https://forums.unraid.net/topic/38582-plug-in-community-applications/)
## Basic Installation
2023-01-03 22:07:05 +00:00
1. Head to the `Apps` tab of unRAID (Community Applications), and search `plex meta manager` in the upper right search box. There will be a couple of results shown, but you should ignore them ([Why?](images)) and use the official image.
2022-03-08 08:06:22 +00:00
2023-01-03 22:07:05 +00:00
2. Click the `Install` button on the Template from Sohjiro's Repository Tools.
2022-03-08 08:06:22 +00:00
2023-01-03 22:07:05 +00:00
3. Choose which branch you want to run `latest`, `develop`, or `nightly`.
2022-03-08 08:06:22 +00:00
2023-01-03 22:07:05 +00:00
4. Click `Show more settings...` to set any [Environmental Variables](../../home/environmental) you wish to use. **None are required for PMM to work.**
2022-03-08 08:06:22 +00:00
2023-01-03 22:07:05 +00:00
* For example if you wish to have the container perform a run immediately and then shut down set `Run Immediately (--run)` to `true`.
2023-01-03 22:07:05 +00:00
5. Hit `Apply`, and allow unRAID to download the docker container.
2022-03-08 08:06:22 +00:00
2023-01-03 22:07:05 +00:00
6. Navigate to the `Docker` tab in unRAID, and stop the `plex-meta-manager` container if it has auto-started.
2022-03-08 08:06:22 +00:00
2023-01-03 22:07:05 +00:00
6. Create `config.yml` and `library.yml` files as-per the [documentation](../../config/configuration) in the Host Path you set (/mnt/user/appdata/plex-meta-manager by default)
2022-03-08 08:06:22 +00:00
7. Once finished, run the container. Voila! Logs are located in `yourhostpath/logs`.
## Advanced Installation (Authenticating Trakt or MyAnimeList)
Due to how unRAID handles docker containers, it can be a little confusing at first to enable Trakt, MyAnimeList, and other sources. At this time, these sources require you to follow through to a URL, and provide a code or link to Plex Meta Manager. unRAID doesn't have a built-in way to interact with the terminals of docker containers, so a workaround must be used:
1. Stop the Plex Meta Manager docker container if it's currently running.
2. Follow the instructions for either [Trakt](../../config/trakt) or [MyAnimeList](../../config/myanimelist), and add the relevant values to your `config.yml`
3. Edit the `Time to Run` variable to reflect a time that is NOT the current time. We don't want the script to be running right now. Set `Run` to `false` if you've chosen to add that variable. Then, start the container.
4. Click the Terminal button in the upper right corner of the unRAID WebUI (`>_`)
5. Run `docker exec -it plex-meta-manager /bin/bash`
2022-03-08 08:06:22 +00:00
Note: this name is case-sensitive. If this gives you an error like "Error: No such container: plex-meta-manager"; check the container config to see if you've named it something like "Plex-Meta-Manager", If that's the case, change the name in the command to match your container.
6. Run `ls` to make sure you're in the same directory as `plex_meta_manager.py`. If you don't see the script, run `cd /`
2022-03-08 08:06:22 +00:00
7. Run `python plex_meta_manager.py -r`, and watch as the script comes to life.
8. You'll now notice, as per the [configuration documentation](../../config/configuration) on these sources, the script will ask you to click a URL and return an input. Go ahead and do so in this terminal window.
9. Once finished, and the script succeeds in connecting to your source, press `Ctrl + C` to cancel the script - and close out of the terminal window. Go ahead and stop the docker container, restore your container settings to your original preferences (restore `Time to Run`), and start the container.