You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
59 lines
2.9 KiB
59 lines
2.9 KiB
# Docker Images
|
|
|
|
You should use the official docker image:
|
|
|
|
```
|
|
meisnate12/plex-meta-manager
|
|
```
|
|
|
|
All the examples in the wiki are assuming the use of this image, and many do not work with non-official Docker images due to differences in how the authors have chosen to construct their images.
|
|
|
|
One alternate image we see a lot is the Linuxserver image, due to its prominent placement in unRAID and linuxserver's general reputation.
|
|
|
|
## LinuxServer
|
|
|
|
The first image offered in unRAID for Plex Meta Manager is the Linuxserver.io image [`linuxserver/plex-meta-manager`]
|
|
|
|
This image is different to the official image [meisnate12/plex-meta-manager] in a few ways that cause a variety of problems particularly for new users.
|
|
|
|
One typical error is something like:
|
|
|
|
```
|
|
Path does not exist: /run/s6/services/plex-meta-manager/config/SOMETHING
|
|
```
|
|
|
|
The result is that the stock config file and a lot of the examples found in the wiki and config repo don't work.
|
|
|
|
If you use the LSIO image you should be aware of the following.
|
|
|
|
The LSIO image:
|
|
|
|
1. requires absolute paths in the config. /config/Movies.yml, not config/Movies.yml. Because of this most of the examples in the wiki and config repo don't work as-is with lsio. Config files that work outside of docker often fail because of this with an error referring to `/run/s6/services/...`.
|
|
|
|
2. only has `latest` version, no `develop` or `nightly`. If you want to switch to `develop` or `nightly` to try a new feature, they aren't available with LSIO image.
|
|
|
|
3. doesn't support [runtime flags](../../essentials/environmental.md), only ENV vars. This means that a command like:
|
|
|
|
```
|
|
docker run -it --rm -v /opt/pmm/config:/config linuxserver/plex-meta-manager --config config/config.yml -r --run-libraries "Movies - 4K DV"
|
|
```
|
|
|
|
doesn't work with the LSIO image; it would have to be:
|
|
|
|
```
|
|
docker run -it --rm -v /opt/pmm/config:/config -e PMM_CONFIG=/config/config.yml -e PMM_RUN=true -e PMM_LIBRARIES="Movies - 4K DV" linuxserver/plex-meta-manager
|
|
```
|
|
|
|
4. doesn't do manual runs correctly; they loop over and over. That command in the previous bullet point [which uses `PMM_RUN` to run it right now] will run over and over until you manually kill the container. The same thing using the official image will run once and quit, as expected.
|
|
|
|
5. Resets ownership of entire config dir every run. In tests, the ownership of the config dir and its contents was set to 911:911 with each run.
|
|
|
|
Generally speaking, we suggest you use the official image instead of lsio.
|
|
|
|
## Others
|
|
|
|
There are 8 other images listed at dockerhub aside from the official image and linuxserver. None of them discuss how they are different beyond one noting it includes `curl`.
|
|
|
|
Unless you have some compelling reason to use one of those, you shouldn't. You should stick with the official image.
|
|
|
|
If you choose to use another image than the default, you should be prepared for the possibility that published examples fail in various ways. |