Installing PlexCache‐D

Installing PlexCache-D

Before You Start

IMPORTANT: If you're currently running the CLI version of PlexCache via User Scripts or cron, disable those scheduled runs first to avoid conflicts. Running both the Docker scheduler and CLI scripts simultaneously can cause race conditions and duplicate file operations.

---

Quick Install with Template

The easiest way to install is using the pre-configured Docker template:

1. Download plexcache-d.xml
2. Place it in /boot/config/plugins/dockerMan/templates-user/ on your Unraid server
3. Go to Docker → Add Container → Select "plexcache-d" from the template dropdown
4. Adjust paths for your setup and click Apply

Or continue below for manual configuration.

---

Docker Container Settings

Basic Settings

Setting	Value
Name	plexcache-d
Repository	ghcr.io/studionirin/plexcache-d:latest
Network Type	Bridge
Privileged	Off
WebUI	http://[IP]:[PORT:5757]

Required Mappings

Name	Host Value	Container Value	Type	Description
Config	/mnt/user/appdata/plexcache-d	/config	Path	Config & data persistence
Cache	/mnt/cache_downloads/	/mnt/cache	Path	Your cache drive
Array	/mnt/user0	/mnt/user0	Path	Array direct access
User	/mnt/user	/mnt/user	Path	User share access
PUID	99	PUID	Variable	User ID (99=nobody on Unraid)
PGID	100	PGID	Variable	Group ID (100=users on Unraid)
TZ	Europe/London	TZ	Variable	Your timezone
Port	5757	5757	Port	Web UI

Optional Mappings (Native Unraid Notifications)

Name	Host Value	Container Value	Type	Description
Unraid Notify Script	/usr/local/emhttp	/usr/local/emhttp	Path (ro)	Unraid's notify script
Notifications	/tmp/notifications	/tmp/notifications	Path	Unraid's notification queue

Note: Without these optional mounts, notifications fall back to webhook-only mode.

Path Notes

Adjust the host paths to match your setup:

• Config: Create this folder for persistent config storage (e.g., /mnt/user/appdata/plexcache-d)
• Cache: Your cache-enabled share where media files are cached (e.g., /mnt/cache_downloads/ or /mnt/cache/)
• Array: Direct array access (bypasses cache), needed for .plexcached backup files
• User: User share access for Plex path resolution

---

First Run

1. Start the container
2. Access the Web UI at http://your-server-ip:5757
3. The Setup Wizard will automatically launch to configure:
   • Plex connection (URL + token via OAuth "Get Token" button)
   • Library selection and path mappings
   • User selection for OnDeck/Watchlist monitoring
   • Cache behavior settings

---

Path Mappings Configuration

During setup, you'll configure path mappings. These tell PlexCache how to translate Plex's media paths to the container's paths.

Example Configuration:

Plex Path	Cache Path	Array Path	Host Cache Path
/data/media/movies	/mnt/cache/media/movies	/mnt/user0/media/movies	/mnt/cache_downloads/media/movies
/data/media/tv	/mnt/cache/media/tv	/mnt/user0/media/tv	/mnt/cache_downloads/media/tv

• Plex Path: The path Plex reports for your media (check Plex library settings)
• Cache Path: Where the file lives on your cache drive (inside the container)
• Array Path: Where the .plexcached backup lives on the array (inside the container)
• Host Cache Path: The actual host path for the mover exclude file (see below)

Docker Path Translation (Important!)

If your cache mount differs between host and container (e.g., host /mnt/cache_downloads → container /mnt/cache), you must configure Host Cache Path in Settings → Paths for each mapping.

This ensures the mover exclude file contains paths that the Unraid mover recognizes. Without this, the mover may incorrectly move your cached files back to the array.