Plex Database Path Changes

Use this when media moves to a new path and you want Plex to keep watch history, metadata, and collections instead of rescanning everything as new.

Before You Begin

Run Compose commands from docker/stacks/nexus so DOCKER_HOST targets nexus.
Plex config lives at /mnt/data/plex on the host and /config in the container.
Media is mounted at /media inside the container.
Know the old and new path prefixes as Plex sees them, for example /data/movies and /media/movies.

Plex must be stopped while you edit the database. Editing a live database can corrupt it.

Change the Paths

Stop Plex

docker compose stop plex

Back Up the Databases

On nexus:

cd "/mnt/data/plex/Library/Application Support/Plex Media Server/Plug-in Support"
cp -a Databases "Databases.bak-$(date +%F)"

Open the Library Database

Use the SQLite build that ships with Plex. It includes extensions the stock sqlite3 lacks. Run it as the Plex user so new files keep the right owner.

docker run --rm -it --user 1000:1000 \
  --entrypoint "/usr/lib/plexmediaserver/Plex SQLite" \
  -v /mnt/data/plex:/config \
  plexinc/pms-docker:latest \
  "/config/Library/Application Support/Plex Media Server/Plug-in Support/Databases/com.plexapp.plugins.library.db"

Preview, Then Rewrite

Check what matches before you change anything.

SELECT id, file FROM media_parts WHERE file LIKE '/data/movies/%' LIMIT 10;
SELECT id, root_path FROM section_locations WHERE root_path LIKE '/data/movies%';

Rewrite file paths and library folders in one transaction.

BEGIN;
UPDATE media_parts SET file = REPLACE(file, '/data/movies/', '/media/movies/') WHERE file LIKE '/data/movies/%';
UPDATE section_locations SET root_path = REPLACE(root_path, '/data/movies', '/media/movies') WHERE root_path LIKE '/data/movies%';
COMMIT;
.quit

Repeat for each moved library, such as /data/series to /media/series.

Start Plex and Verify

docker compose start plex
docker compose ps plex

Wait for the container to report healthy, then play one title from each changed library.

Roll Back

If Plex fails to start or titles show as unavailable:

Stop Plex with docker compose stop plex.
Replace Databases with the Databases.bak-<date> copy.
Start Plex with docker compose start plex.

Don’t empty the Plex trash or run Clean Bundles until playback works. Either action permanently removes items Plex thinks are missing.

Get Started

Services

Platform

Infrastructure

Runbooks

Help

Plex Database Path Changes

Before You Begin

Change the Paths

Roll Back

​Before You Begin

​Change the Paths

​Roll Back

Before You Begin

Change the Paths

Roll Back