62 lines
4.4 KiB
Markdown
62 lines
4.4 KiB
Markdown
# REPORT — the media folder fix in the live catalog (one drive), 2026-10-14
|
|
|
|
> A topic report (`CLAUDE.md`: parallel sessions do not share the root `REPORT.md`). Evidence:
|
|
> `documentation/audits/media-folder-fix-2026-10-14/`. Architecture read: `15-media-library.md`, `07` §6,
|
|
> `09` §1.2/§3; the first task's report.
|
|
|
|
## In plain words
|
|
|
|
1. **Does the media chain work now for a customer with one drive?** Yes. Proven on demo-hp guest 9201 with the live
|
|
catalog: Radarr and qBittorrent installed through the dashboard, one public-domain film handed to Radarr; the film in
|
|
the library is the downloaded file under a second name (link count 2, one inode). No extra space.
|
|
2. **Can the download apps reach the photos?** No. Inside qBittorrent and Transmission the `media/photos` path does not
|
|
exist; the media folder shows only their own download folder. A write to the photos path lands only in the
|
|
container's own layer; the photos on the drive stay unchanged (bench).
|
|
3. **What happens to an app that was already installed?** It gets the new template from the catalog sync and uses it
|
|
at its next start. Its old torrents keep seeding: the old `/downloads` path stays, as a second name of the same folder.
|
|
New downloads go to the same-path folder. Measured on the bench for both download apps: an install from the old
|
|
template, then updated.
|
|
4. **Backup, export, remove: unchanged in meaning?** Yes. Sonarr/Radarr's new `media` bind is declared `excluded`:
|
|
no backup tier, no export, no removal touches it. Without that line the whole `media` folder, photos included, would
|
|
have gone into every tier and off-site — measured with the controller's own code. Transmission's `watch` folder is
|
|
now declared too; before, it went off-site by mistake.
|
|
5. **Sonarr/Radarr sign-in default:** seeded. A new install starts with „Authentication Required: Enabled". An existing
|
|
install keeps the household's choice. Until the household makes its first admin, other apps on the box can still read
|
|
the API key — filed as R-1040.
|
|
6. **Claims in the brief that turned out wrong:**
|
|
- „a write outside the download folder fails" — the write succeeds, but only inside the container; nothing reaches
|
|
the drive (B-3).
|
|
- „`/media/shows` in Sonarr and Jellyfin" — also in Plex, and in Jellyfin's prerequisites too.
|
|
- Part A: the hub's `/apps` page gives a COUNT per app, not the boxes. The boxes were read one by one; the hub's
|
|
„2" = Tester 1 (the rig) + an older report from demo-felhom's sizing bench.
|
|
- The first report's top line had been pushed down by my own final edit; restored at the top.
|
|
|
|
## What changed
|
|
|
|
- **app-catalog `bc54c01`** — sonarr, radarr (one `media` bind, `excluded`; first-start seed; first steps hu+en);
|
|
qbittorrent, transmission (only their folder at the same path; `/downloads` kept; default folders moved at start;
|
|
watch declared); plex, jellyfin (`/media/tv`); onboarding 2.2 rows; copy freeze (only these lines). CHANGELOG +
|
|
REPORT there.
|
|
- **felhom.eu** — `09` §3 decisions 242 (D9 = A with a limit) and 243 (the N100 waits); `15` §2 ruled table; evidence.
|
|
|
|
## Gates and measurements
|
|
|
|
- `catalog_gates.py --fast` for the six apps: all OK (the copy gate first caught a Hungarian suffix error, „filmra" →
|
|
„filmre", fixed).
|
|
- `check-volume-persistence.py` on the bench: sonarr, radarr, qbittorrent, transmission, jellyfin CLEAN; plex
|
|
UNDETERMINED (`/transcode` empty after the exercise; plex's folders did not change in this task).
|
|
- Downloads: public domain only, archive.org; removed after the read-back (Radarr deleted the film with its files,
|
|
qBittorrent deleted the torrent with its data); both apps removed WITHOUT „delete data". qBittorrent stalled on
|
|
archive.org's last piece again; a throwaway Transmission on the bench gave it as a local peer (R-1039).
|
|
|
|
## Register
|
|
|
|
Rows: before 156 → after 154. Opened 2 (R-1039, R-1040). Closed 4 (R-1014, R-1015, R-1016, R-1030). Narrowed 1
|
|
(R-1019: the watch half fixed; the Tier-2 mirror of optional downloads stays open). STATUS: 52 lines; D9 removed (ruled).
|
|
|
|
## Teardown
|
|
|
|
Machine: demo-hp 9201 — Radarr and qBittorrent removed, their volumes gone, the household folders kept (empty
|
|
`movies`, `torrents/.temp`). Bench 9401 — throwaway containers, folders and the catalog copy removed; the bench is left
|
|
RUNNING (it was stopped before this task). Host: nothing changed. Hub: read only. Tester 1 and the N100: untouched.
|