No Windows-side robocopy. Everything on D: (PMS dir, Calibre, Nikola
iPad) is copied to the NAS media_pc share from Linux, Media/ staged via
the SSD, D: formatted ext4 BEFORE Plex first starts, thumbnails live on
/srv/data. Fixes the M3 restore path that pointed at the unmounted
Share. Per Mike 2026-07-31.
Reverses the forward-only decision. That call predated measuring the library;
at 27 TB / 25,148 video items / 337 GB of generated preview cache, rebuilding
costs 1-3 weeks of saturated gigabit and permanently loses every manual match
fix across 23,493 episodes. Migration preserves watch history, resume points,
collections, playlists, manual matches, artwork choices, added-at dates, the
337 GB cache, and server identity - so shared users stay invited, clients do
not re-add, and there is no claim step at all.
migration/remap.sql
Four path columns remapped: media_parts.file (80,126), section_locations
.root_path (11 -> 9), media_streams.url (14,837) and metadata_items.guid (9).
Two formats, not one: backslash/UNC for the first two, file:// with %20
encoding for the last two - decoding those %20s would break every subtitle
reference containing a space, which given share names like Radio Shows is
most of them.
A scan of all 80 text columns across 82 tables found SIX columns matching
korval. Only four are paths. taggings.text is one row reading Dr. Korval,
and metadata_items.summary is four Liaden Universe blurbs about Clan Korval.
A bare REPLACE on the word would have corrupted a cast credit and four book
summaries, so every statement is anchored to a path prefix. Proven against a
synthetic database built from the real path shapes: 12/12, including both
false positives surviving byte-identical.
Also drops the Audio Books and Music Organized roots - configured as library
roots but holding 0 files / 0 bytes. The consolidation had already happened;
only the dead roots remained.
migration/migrate-db.sh
Runs the remap through Plex own SQLite build borrowed from the container
image, keeps a .pre-remap rollback, asserts the counts moved 1:1 and the
false positives did not, then stats 200 random remapped paths against the
real filesystem. That last check is the one that matters - SQL running
without error proves nothing.
migration/gen-preferences.ps1
Plex live settings store on Windows is the REGISTRY, not Preferences.xml,
and the two disagree here. Folds ~50 values into one Linux file, dropping
Windows-only keys including the per-GPU limit keyed by 10de:1b81, the GTX
1070 PCI ID. Preserves MachineIdentifier and the online token, which is what
keeps the server identity. The existing Preferences.xml is malformed anyway
(duplicate allowedNetworks) and will not parse strictly.
scripts/20-cifs.sh
Eight shares down to six. Mount points now mirror the share names verbatim -
/mnt/nas/Home Movies, space and all - because that reduces the remap to one
uniform prefix substitution instead of eleven special cases. New requirement
this creates: \040 escaping in BOTH fstab fields, not just the share name.
Verified, plus a round-trip check that a remapped DB path lands under the
generated mount point.
plex/docker-compose.yml
Six read-only NAS binds whose source path equals target path, so database,
host and container agree with no translation. No PLEX_CLAIM. Phase 2 Media
relocation present but commented.
scripts/60-media-relocate.sh
Post-soak, optional: moves the 337 GB cache to the 3TB ext4 disk so future
growth (~28 MB per content-hour) stops eating the SSD. Plex does not support
this, so the script forces generation on one title afterwards to prove writes
survive the EXDEV boundary, and rollback is deleting a compose override.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
thethreemagi
