ONLINE RUNBOOK
Plex update procedure
A Docker Compose maintenance procedure.
Use your deployment’s Compose directory and service names in the commands below.
Confirm readiness
Verify a recent configuration backup, confirm media storage is mounted, and notify active users if maintenance may interrupt playback.
Connect through the private administrative path
Use the management network or VPN. Confirm the target host and Compose directory before changing anything.
cd <plex-compose-directory> pwd docker compose psPull the approved images
Download the images referenced by the existing Compose configuration.
docker compose pullRedeploy the stack
Recreate changed containers in detached mode, preserving configured persistent storage.
docker compose up -dValidate service health
Check service state and inspect recent logs for startup, database, permission or storage errors.
docker compose ps docker compose logs --tail=100 <plex-service-name>Test the application
Open Plex through the normal user-facing path. Confirm libraries load and test playback from more than one library when practical.
Validation checklist
| Check | Expected result |
|---|---|
| Container | Service runs without a restart loop |
| Libraries | Expected media libraries are visible |
| Playback | A test item starts successfully |
| Remote access | The expected access path remains available |
Safety notes
- Do not delete application configuration or media directories.
- Do not remove persistent volumes during routine maintenance.
- Investigate missing mounts before restarting repeatedly.
- Record the previous image version for rollback.