[2] Merge remote-tracking branch 'chazlarson/qnap-touchups' into nightly

pull/1637/head
meisnate12 1 year ago
commit acef2cc8ab

@ -2,7 +2,106 @@
This is a quick walkthrough of setting up the Plex-Meta-Manager Docker container in the QNAP "Container Station" UI.
Steps.
The "Container Station" UI on your QNAP may differ from these screenshots, but the concepts are the same:
1. Create a container based on the `meisnate12/plex-meta-manager` image.
2. Set environment variables to control the container's behavior [optional].
3. Point the container to the directory where your configuration files are to be stored.
Detailed steps:
````{tab} Container Station v. 3.0.5.623
1. Open Container Station; click “Images”
![](qnap/qnap3-01.png)
1. Select “Pull” from the top-right
![](qnap/qnap3-02.png)
1. Leave Mode set to “Basic Mode”
For the Registry select “Docker Hub”
Under the "Image" section you will be typing in the name and version of the docker image you wish to pull. Type in the image you wish to use as follows:
```
meisnate12/plex-meta-manager:latest
meisnate12/plex-meta-manager:develop
meisnate12/plex-meta-manager:nightly
```
Then click Pull.
![](qnap/qnap3-03.png)
Note: You can repeat this step for each of the different versions and youll end up with this:
![](qnap/qnap3-03a.png)
After the pull is complete the image(s) will now be available for use.
1. From the "Images" menu under the "Actions" column click the "play" button to bring up the “Create Container” option.
![](qnap/qnap3-04.png)
1. "Create Container" Step 1: "Select Image" youve already done this so just click "Next".
![](qnap/qnap3-05.png)
1. "Create Container" Step 2: "Configure Container" - you can edit the name if you wish. From here on youll be working in the Advanced Settings sub-menu. Click on "Advanced Settings".
![](qnap/qnap3-06.png)
1. You can add [command-line switches](../environmental) to the "Command" field here. Do not edit the "Entrypoint" field.
![](qnap/qnap3-07.png)
For example, if you wanted to run the collections you have defined as tests, add the `--run-tests` command-line flag:
![](qnap/qnap3-08.png)
Generally speaking, editing these is not recommended as it is easy to render the container non-functional by doing so.
It is more typical in Docker contexts to set these things with environment variables.
Anything you can do via command-line arguments can be done with [Environment Variables](../environmental), which is more typical in Docker environments.
For example, you could add an environment variable named `PMM_TESTS` with a value of `true` to run the collections you have defined as tests.
Click "Environments" on the left to set environment variables.
1. Select "Storage":
![](qnap/qnap3-09.png)
1. Click the Trash Can icon to remove the default Storage Mapping:
![](qnap/qnap3-10.png)
1. Click "Add Volume" then choose “Bind Mount Host Path”:
![](qnap/qnap3-11.png)
1. Select the Yellow Folder icon
![](qnap/qnap3-12.png)
“Select Host Path” will appear as seen below, letting you select the folder you want to use.
![](qnap/qnap3-13.png)
After selecting your folder and choosing "Apply" the "Host" path will be filled in. For the "Container" path you MUST use `/config`:
![](qnap/qnap3-14.png)
1. Select Next to advance to “Step 3 Summary”
1. Select Finish
````
````{tab} Container Station v. unknown
1. Open Container Station; click "Create" in the left column.
@ -30,11 +129,15 @@ Steps.
2. Change the container name if you wish.
Command line arguments can be entered in the "Entrypoint" field after `/tini -s python3 plex_meta_manager.py --` IMPORTANT: DO NOT REMOVE ANY ELEMENT OF THAT COMMAND.
Command line arguments can be entered in the "Entrypoint" field after `/tini -s python3 plex_meta_manager.py --`
IMPORTANT: **DO NOT REMOVE** ANY ELEMENT OF THAT TEXT. DO NOT ENTER ANYTHING INTO THE "Command" FIELD.
For example, you could enter the following into the "Entrypoint" field to make PMM run immediately when the container starts up: `/tini -s python3 plex_meta_manager.py -- --run`
For example: `/tini -s python3 plex_meta_manager.py -- --run`
Typically, in a Docker environment, this sort of thing is done via Environment Variables [the next step here]. Editing the "Entrypoint" is not recommended, as it's easy to render the container non-functional if you are not sure what you're doing.
Information on available command line argument can be found [here](../environmental)
Information on available command line arguments can be found [here](../environmental)
Click "Advanced Settings >>"
@ -44,6 +147,10 @@ Steps.
3. Environment Variables can be added here:
Anything you can do via command-line arguments can be done with Environment Variables, which is more typical in Docker environments.
For example, you could add an environment variable named `PMM_RUN` with a value of `True` to make PMM run immediately when the container starts up.
Information on available Environment Variables can be found [here](../environmental)
@ -55,6 +162,7 @@ Steps.
Click "Add" in the middle section "Volume from host".
"Volume from host" is the location on your QNAP where you want to store the config files.
"Mount Point" must be `/config`
When finished, click "Create".
@ -62,3 +170,4 @@ Steps.
![](qnap/qnap7.png)
````

Binary file not shown.

After

Width:  |  Height:  |  Size: 327 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 317 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 330 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 327 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 319 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 190 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 203 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 197 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 202 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 190 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 197 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 193 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 196 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 196 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 201 KiB

Loading…
Cancel
Save