Repository navigation
feat(media): add Navidrome to stacks/media, with its state in the NAS pull - #628
Merged
Merged
Conversation
… pull Navidrome joins Jellyfin on smaug as the tier's music server. It speaks the Subsonic API, so its clients are existing phone apps. The service shape comes from a scratch boot of the pinned image (0.64.1): - It runs as 65534, read-only, with cap_drop ALL. The image declares no user. - /cache is a 65534-owned tmpfs. The image has no /cache, and a root named volume there aborts the process a second after it reports ready. - Plugins are off, which keeps a 0700 /data/plugins out of what the backup user reads. - The wget healthcheck hits /ping, which answers 200 before any admin exists. - The admin is created with `navidrome user create --admin` from the TrueNAS shell. After that the web form that hands it to the first visitor answers 403. There is still no secrets file (#528). The issue said no new firewall rule was needed. The 50 -> 40 it relied on is two port-scoped passes, 443 and 8096, and the phones are on Hicks. So a fifth pass, 50 -> 10.0.40.30:4533, is written into build-the-nas §0.5, and the new §6.5 creates it along with the deploy. Navidrome's database holds playlists and play counts, so it is backed up the way Jellyfin's watch history is. backup-nas.sh now pulls two archives, jellyfin-config and navidrome-data, from one snapshot. It sizes both before transferring either, and names a directory missing from the snapshot. It verifies each set against its own MANIFEST, so the one-archive sets already retained stay valid. Authored, not deployed: the deploy waits on the mirror being whole (#558). Refs #141 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Allow 4533 to smaug now exists on Hicks (opt2 / igc0.50), directly under Allow 8096 to smaug and above Block access to CasaBonita. It was inserted from morpheus's shell as a copy of the 8096 rule with the port changed, and saved as a config revision named for #141. `pfctl -sr -vv` reads https, 8096, 4533 and then the block on igc0.50. The monitoring host is refused on 4533, and the igc0.40 tripwire reads 0 packets. The rule came before the service because a pass to a port with no listener opens nothing. The rest of §6.5 still waits on #558. Refs #141 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
#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>
…41-e0d8aa # Conflicts: # docs/changelog.md
Gerrrt
added a commit
that referenced
this pull request
Sep 22, 2026
Navidrome took build-the-nas.md §6.6 first, so version collection is §6.7 and every reference this branch added moves with it. Changelog: both 2026-09-22 entries kept. 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 #141. This PR authors Navidrome into
stacks/media. It does not deploy it, so the issue stays open until the service is running on smaug and the fifth pass exists.What changes
stacks/media/compose.yaml,.env.example: anavidromeservice in the stack's existing shape: digest-pinned, uid 65534,read_only,cap_drop: ALLand a 1 GiB ceiling. It publishes4533. It gets/dataas a bind mount onerebor/apps/navidrome/dataand/musicread-only fromerebor/media/music. Everything non-obvious comes from a scratch boot of the pinned image, and the comments record it:/cache. With a root named volume mounted there, the process aborts a second after it reports ready, so/cacheis a tmpfs owned by 65534.ND_PLUGINS_ENABLED=falsestops it creating a0700/data/plugins./pinganswers 200 before any admin exists, so the healthcheck can't deadlock on first boot.navidrome user create --admin, run from the TrueNAS shell right afterup. After that, the web form that would hand the admin to the first visitor answers 403. The stack still has no secrets file, per stacks/media has no secrets file: Jellyfin's admin credential lives only in a password manager #528.50 → 10.0.40.30:4533. The issue said no rule was needed, but Media tier: Jellyfin — placement answers the terminal-VLAN problem #138's passes are port-scoped (443 and 8096) and the phones are on Hicks. It is written intobuild-the-nas.md§0.5 and was created on 2026-09-22, ahead of the deploy (§6.5 step 1). It sits directly underAllow 8096 to smaugon Hicks.pfctl -sr -vvreads https, 8096, 4533 and then the block, the monitoring host is refused on 4533, and theigc0.40tripwire reads 0 packets.scripts/backup-nas.shnow pulls two archives from one snapshot,jellyfin-configandnavidrome-data:backup-volumes.shgainsnavidrome-data's sentinel and companions.Verified
scripts/validate.sh: all checks pass (3 skipped, the usual worktree skips). The media health probe ranwgetinside the pinned Navidrome image.navidromeservice block, booted against scratch paths:healthyas 65534,/ping200, nopluginsdirectory in/data.backup-nas.shbench-run over real ssh against a fake snapshot tree onoracle:--verify-only --allpassed on a legacy one-archive set beside it.navidrome/datafailed by name before any set directory was created.Deploy notes (after merge, by hand)
ereborlostZVTBSDL3at lifetime hour 27, node_exporter hung nine minutes before the fault, anderebor/appshas no copy anywhere else #558). The roadmap gates this on it.navidrome/datain every snapshot. Deploy on smaug (§6.5) before the next Saturday 03:30 UTC run after the checkout moves, or that run fails, loudly and without writing anything.🤖 Generated with Claude Code