ONLINE RUNBOOK

Plex update procedure

A Docker Compose maintenance procedure.

Use your deployment’s Compose directory and service names in the commands below.

  1. Confirm readiness

    Verify a recent configuration backup, confirm media storage is mounted, and notify active users if maintenance may interrupt playback.

  2. 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 ps
  3. Pull the approved images

    Download the images referenced by the existing Compose configuration.

    docker compose pull
  4. Redeploy the stack

    Recreate changed containers in detached mode, preserving configured persistent storage.

    docker compose up -d
  5. Validate 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>
  6. 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

CheckExpected result
ContainerService runs without a restart loop
LibrariesExpected media libraries are visible
PlaybackA test item starts successfully
Remote accessThe expected access path remains available

Safety notes