Repository navigation
feat(media): author Audiobookshelf beside Jellyfin, behind a fifth Hicks pass (#140) - #629
Merged
Merged
Conversation
…cks pass Audiobookshelf joins stacks/media for the one thing Jellyfin does not do: listening progress that follows a person between devices. It is authored and validated here; deploying it on smaug is build-the-nas.md §6.5, which waits on the mirror being whole (#558). The issue said no rule beyond #138's 50→40 would be needed. There is no such rule - Hicks reaches smaug on 443 and 8096, one pass per port - and the phones are on Hicks, so the service brings a fifth pass, `Allow 13378 to smaug`, created when it is deployed. ADR-0050 records that, audiobooks only with podcasts deferred behind a read-only library, and the backup shape. Measured on the pinned image first: it binds port 80 by default, which a capability-less non-root process cannot (PORT=13378); /config and /metadata do not exist in the image; its entrypoint is tini (init: false, as for Immich); the database is in rollback-journal mode; 91 MiB idle. The admin reset was proved on a scratch boot, not described. backup-nas.sh now pulls a table of archives from one snapshot instead of one path, so Audiobookshelf's database leaves the NAS with Jellyfin's. Its row is `pending` until §6.5's Done commit flips it: skipped by name while its directory is absent, so merging this does not fail Saturday's Jellyfin pull. Verification reads each set against its own MANIFEST, so the retained Jellyfin-only sets still verify - both were re-verified, and a bench pull on oracle covered the skip, a missing sentinel and two archives. backup-volumes.sh's compose parser learns that a ${VAR}-spelled source is a host path, which it already was. Refs #140 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Gerrrt
added a commit
that referenced
this pull request
Sep 22, 2026
#629 and this branch each rewrote the same files for a second media service. Main's side is the base and Navidrome is added on top of it: - backup-nas.sh is #629's table, including its pending/required state. navidrome-data joins it as a pending row. This branch's own two-archive rewrite is dropped. - backup-volumes.sh gains the navidrome-data sentinel and companions in #629's version of the tables. - compose.yaml and .env.example carry all four services. - build-the-nas.md keeps §6.5 for Audiobookshelf. Navidrome's steps move to §6.6 and use the same pending -> required flip, which replaces the Saturday-ordering hazard this branch used to document. - Passes are named by port. 4533 exists as of 2026-09-22, so it is the fifth. 13378, which ADR-0050 calls the fifth, will be the sixth. Refs #141 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Refs #140. Authors Audiobookshelf in
stacks/media. Nothing is deployed onsmaugby this PR. Deploying isbuild-the-nas.md§6.5, and the roadmap holds that until the mirror is whole (#558). The issue stays open until the service is deployed and a NAS set holds its archive.Two premises in the issue were wrong
10.0.40.30through two port-scoped passes,443and8096, and the phones are on Hicks. Audiobookshelf listens on13378, so it needs a fifth pass,vlan50 net → 10.0.40.30:13378, namedAllow 13378 to smaugand placed above Block access to CasaBonita. You create it in pfSense as step 1 of §6.5. The docs describe it as specified, not as existing.backup-nas.shpulled one hard-coded path (jellyfin/config). The listening-progress database would have been snapshotted nightly and never left the NAS.What changed
stacks/media/compose.yaml: a newaudiobookshelfservice, pinned by digest, running as 65534 with a read-only root,cap_drop: ALL,init: false, a 1 GiB ceiling and a busybox-wgethealthcheck. The library is mounted read-only, so this is audiobooks only and podcasts are deferred. Every non-obvious line is backed by a measurement on the pinned image, recorded in theMEASUREDblock.scripts/backup-nas.sh:audiobookshelf-stateholdsconfig/andmetadata/.pending. While its directory is absent it is skipped, and the skip is logged by name. Once the directory exists it is pulled and verified strictly. §6.5's Done commit flips the row torequired. Without this, merging would have failed every Saturday's Jellyfin pull until the deploy.--verify-onlychecks each set against its own MANIFEST, so the Jellyfin-only sets already kept still verify.scripts/backup-volumes.sh: a sentinel and companions foraudiobookshelf-state. The compose parser no longer reads a${VAR}/sub:/mntbind mount as a named volume. Inventory output is byte-identical for observability, sensitive and lab.socdiffers only in the script name inside its existing missing-sentinel error.build-the-nas.md: §0.5, §0.6, §4, §6.3, a new §6.5 with a Done block to fill in, §7 and §8.network.md,security.md,architecture.md,roadmap.md,changelog.md,restore-the-stack.md,schedule-maintenance.md,successor-handover.md,observability.mdandREADME.md.Verification
/configand/metadata;mediaProgresses;stacks/media/compose.yaml: healthy in about 9 s,/healthcheckreturns 200, and no tini warning. Torn down withdown -vafterwards.oracle(with--local-only, into the worktree), exit codes as expected in all three cases:--verify-only --allunder the new script.scripts/validate.shpasses, before and after rebasing on main. The only skips are the usual worktree-only systemd checks.Left for you, in order
ereborlostZVTBSDL3at lifetime hour 27, node_exporter hung nine minutes before the fault, anderebor/appshas no copy anywhere else #558 has the mirror whole, work through §6.5 onsmaug: the pfSense pass, the directories, re-fetching the stack, the root user, and a phone test of progress sync.morpheus, runmake backup-nasfrom the main checkout to see both archives, flip the row torequired, fill in the Done block, and the issue closes then — by hand, not by this merge.🤖 Generated with Claude Code