Compare commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
51abc6550d | ||
|
|
64f489023e | ||
|
|
3511e04ae9 | ||
|
|
21b7ad15d9 | ||
|
|
4ad55c28a0 | ||
|
|
c9a8469d04 | ||
|
|
5794b07c32 | ||
|
|
1a47b831ee | ||
|
|
5be66df2bb | ||
|
|
d3aedd1837 |
No files matched your search
+8
-1
@@ -290,7 +290,14 @@ audiobooks.franksdank.cloud {
|
||||
}
|
||||
}
|
||||
|
||||
# --- Jellyfin ---
|
||||
# --- Jellyfin (exempt by construction: own auth) --------------------------
|
||||
# No Anubis, no outpost: Jellyfin carries its own complete login (its own
|
||||
# account store, no Authentik link), which is the policy's exempt category —
|
||||
# the same family as plex/ABS/*arr around it. Accepted exposure: the sign-in
|
||||
# form is internet-visible with no rate limiter on either side (this Caddy
|
||||
# build ships no rate_limit module), so accounts need long unique passwords.
|
||||
# The homepage card opened it to the household on 2026-11-03; accounts are
|
||||
# created in Jellyfin's own admin UI, not by SSO.
|
||||
jelly.franksdank.cloud {
|
||||
reverse_proxy 192.168.0.235:8096
|
||||
}
|
||||
|
||||
@@ -47,6 +47,12 @@ Volume=/home/dank/Containers/jellyfin/cache:/cache
|
||||
# is the guard: started against a plain, unmounted view directory a scan decides
|
||||
# the library is empty and deletes what it cannot see.
|
||||
Volume=/var/lib/media-meta/view:/data
|
||||
# Big-screen theme for the TV. The repo file replaces the container's "Media
|
||||
# Center" theme slot; the upstream dark palette stays live because the file
|
||||
# @imports it, so an image bump cannot strand a vendored CSS snapshot. Read-only
|
||||
# — the web app only fetches it. A client opts in with
|
||||
# Display Settings -> Theme -> "Media Center".
|
||||
Volume=/home/dank/serverAppConfigs/dankserver/jellyfin/theme/wmc/theme.css:/jellyfin/jellyfin-web/themes/wmc/theme.css:ro
|
||||
AddDevice=/dev/dri
|
||||
GroupAdd=keep-groups
|
||||
HealthCmd=curl -f http://localhost:8096/health
|
||||
|
||||
@@ -0,0 +1,53 @@
|
||||
/*
|
||||
* Dank fleet big-screen theme for jellyfin-web.
|
||||
*
|
||||
* Deployed by bind-mounting THIS file over the container's "Media Center"
|
||||
* theme (`/jellyfin/jellyfin-web/themes/wmc/theme.css`) — see the Volume line
|
||||
* in dankserver/jellyfin/quadlet/jellyfin.container. The slot is deliberately
|
||||
* one nobody picks by accident, and its name is the only thing that changes:
|
||||
* the colors are the live upstream dark theme, pulled in by @import below, so
|
||||
* this file never vendors a snapshot of upstream CSS and cannot drift when the
|
||||
* Jellyfin image moves.
|
||||
*
|
||||
* Why it exists: the living-room client (Jellyfin Desktop on danklivingroom)
|
||||
* renders this server-served web app at 3840x2160 with no client-side scaling,
|
||||
* so 14 px body text lands on a big panel viewed from three metres. `zoom` on
|
||||
* the root element is the one lever that scales the whole UI — the layout code
|
||||
* measures layout px, so card grids re-flow to fewer, larger columns instead of
|
||||
* overflowing.
|
||||
*
|
||||
* Adoption is per device, not global: Display Settings -> Theme ->
|
||||
* "Media Center" on the screen that wants it. That is the point — a phone
|
||||
* browser on the same server must not get a 1.75x interface.
|
||||
*
|
||||
* Change the size by editing the single number. 1.5 is mild, 1.75 is the
|
||||
* three-metre default, 2.0 is for a projector.
|
||||
*/
|
||||
|
||||
@import url("../dark/theme.css");
|
||||
|
||||
:root {
|
||||
/* Marker the e2e gate reads back; also a tweak hook for a per-client
|
||||
override injected by anyone who really wants one. */
|
||||
--dank-big-screen: 1;
|
||||
--dank-big-screen-zoom: 1.75;
|
||||
}
|
||||
|
||||
html {
|
||||
zoom: var(--dank-big-screen-zoom);
|
||||
}
|
||||
|
||||
/* A remote moves focus in discrete jumps, so the ring has to survive a
|
||||
three-metre read. */
|
||||
.emby-focus,
|
||||
button:focus-visible,
|
||||
a:focus-visible,
|
||||
.inputElement:focus-visible {
|
||||
outline: 3px solid var(--accentColor, #00a4dc) !important;
|
||||
outline-offset: 2px !important;
|
||||
}
|
||||
|
||||
/* Scrollbars are mouse furniture; on a TV they are noise at this size. */
|
||||
* {
|
||||
scrollbar-width: none;
|
||||
}
|
||||
@@ -61,6 +61,9 @@ Dankserver. Change it in **Settings → Users → frank → Password**; the secr
|
||||
then holds a stale value and only matters again if the `config` bind is ever
|
||||
destroyed (a fresh DB makes the script create a new owner from it).
|
||||
|
||||
That value is the live password, not a leftover: it bcrypt-matches `users.pash` in the state
|
||||
DB (2026-11-03), so `local` does open the door when authentik is down.
|
||||
|
||||
A full scan is slow and runs in the background; watch the `items:` total climb,
|
||||
never `/healthcheck`. It also reads files that are genuinely broken and logs
|
||||
`[AudioFileScanner] Invalid data found when processing input` per file — that is
|
||||
@@ -90,6 +93,15 @@ inside the user object. A client that reads `response.token` gets the empty stri
|
||||
`Authorization: Bearer ` with nothing after it, and every `/api/*` call then answers `401`
|
||||
as though the password were wrong.
|
||||
|
||||
**`POST /api/login` is not a route.** Local login is `POST <base>/login`, and the `/api`
|
||||
bearer guard answers anything else with a bare `401 Unauthorized` while logging **nothing** —
|
||||
no `[LocalAuth]` line — so a wrong path is indistinguishable from a wrong password unless the
|
||||
journal is read too. Same family as the absent `/setup` route named in
|
||||
`scripts/audiobookshelf-init.sh`. To settle a suspected stale credential without signing in:
|
||||
bcrypt-compare the recorded value against `users.pash` in
|
||||
`/home/dank/Containers/audiobookshelf/config/absdatabase.sqlite`, opened read-only
|
||||
(`file:<path>?mode=ro`).
|
||||
|
||||
## Listeners (accounts)
|
||||
|
||||
The door is public now, so the account is the only gate between a listener and the library.
|
||||
@@ -103,7 +115,14 @@ Two ways in, both per listener:
|
||||
listener, because the claim grants that role to every signer. To shut a listener off,
|
||||
disable or delete their user in Audiobookshelf — no IdP group membership can withhold it.
|
||||
|
||||
Nothing rate-limits `/audiobookshelf/api/login` — this Caddy build carries no `rate_limit`
|
||||
What auto-registration hands out (read off the state DB, 2026-11-03): `accessAllLibraries:
|
||||
true` and `download: true` — every household signer lands on the **whole** library with
|
||||
offline downloads already on. Narrow it per account in **Settings → Users → <name>**. The DB
|
||||
is the census when no admin token is at hand; `GET /api/users` returns the *limited* shape
|
||||
(no `active`, no `librariesAccessible`), so a missing key there is not a denial, and an
|
||||
account created by SSO has `pash` NULL with its IdP link at `extraData.authOpenIDSub`.
|
||||
|
||||
Nothing rate-limits `POST /audiobookshelf/login` — this Caddy build carries no `rate_limit`
|
||||
module and ABS 2.37.2 ships no lockout — so the form is a guessing target exactly like
|
||||
`jelly.`, `plex.` and the *arr logins already are. The mitigation is credential hygiene:
|
||||
long unique passwords per listener, never a reuse of the root password.
|
||||
@@ -127,12 +146,15 @@ the local form, and the phone app offers SSO on its server-address screen. The l
|
||||
|
||||
With `authOpenIDAutoRegister` on, a first sign-in creates the account and the claim alone
|
||||
decides its type — and the claim always carries `user`, so **the IdP is now the library gate**:
|
||||
any authentik account that can reach this application becomes a listener. That is the intent
|
||||
(the household signs in with the accounts it already has), which makes two things worth
|
||||
checking when they change: whether authentik's own invitation/signup flow stays something only
|
||||
Frank drives, and whether an access policy should be bound to the `audiobookshelf` application
|
||||
to narrow who may even reach the login. Revoking one person is a disable/delete of their ABS
|
||||
user; revoking everyone is that policy.
|
||||
any authentik account that can reach this application becomes a listener. That is the
|
||||
intent (the household signs in with the accounts it already has), and its breadth is
|
||||
accepted on purpose: no access policy is bound to the `audiobookshelf` application, and
|
||||
the wide auto-registered default (every library, downloads on) is **not a defect to fix** —
|
||||
Frank's call, 2026-11-03. Narrowing stays a per-account judgement in **Settings → Users**.
|
||||
The one thing still worth watching is authentik's own invitation/signup flow: it must
|
||||
remain something only Frank drives, because an account created there is a listener the
|
||||
moment it signs in. Revoking one person is a disable/delete of their ABS user; revoking
|
||||
everyone is that signup flow.
|
||||
|
||||
Both halves — authentik's provider row and ABS's settings — are asserted end to end by the Playwright gate named in *Verification*. `23-` signs in as `qa-e2e-admin` and must land inside the app with site-admin rights; `24-` signs in as the standard identity, which is in no Audiobookshelf group, and must land as a listener. Together they pin the escalation and the default: a mapping that stops granting silently locks the household out, and a mapping that over-grants turns the household into site admins.
|
||||
|
||||
|
||||
@@ -3,7 +3,7 @@ type: reference
|
||||
title: Jellyfin
|
||||
description: "Jellyfin on Dankserver: quadlet unit, overlay metadata view, provider keys, ports, access, transcode status."
|
||||
tags: [jellyfin, dankserver, media-server]
|
||||
timestamp: 2026-11-02T11:00:00Z
|
||||
timestamp: 2026-11-03T11:40:00Z
|
||||
---
|
||||
|
||||
# Jellyfin
|
||||
@@ -383,6 +383,65 @@ folder created under `/data/Movies`: it stays invisible until a recursive refres
|
||||
names it. So every pass that writes into a library ends by firing one, and "Jellyfin
|
||||
does not see the file I just moved in" is the designed answer, not a fault to chase.
|
||||
|
||||
## API-key ledger and rotation
|
||||
|
||||
`/Auth/Keys` is the ledger. `GET` lists every key **with its `AccessToken` in
|
||||
cleartext**, so an admin token in hand prints the whole fleet's keys;
|
||||
`POST /Auth/Keys?app=<name>` mints one and answers `204` **with no body** — the
|
||||
new token is read back from the `GET`, never from the create response.
|
||||
`DELETE /Auth/Keys/{token}` revokes **by the token string**, and a parameter that
|
||||
matches nothing answers `204` too, so `204` there is not proof anything was
|
||||
removed. Discover a route's verb from the `Allow` header of an `OPTIONS` (or
|
||||
`GET`) response — never by firing `DELETE` at a guess.
|
||||
|
||||
- `IsActive` reads `False` on rows that authenticate `200`. It is not a usability
|
||||
signal; only an authenticated request is.
|
||||
- `DateLastActivity` never moves off `0001-01-01` on 12.4, so "is this key in
|
||||
use?" cannot be answered from the ledger. The census is repo + host credential
|
||||
stores + the `Devices` table (whose `DateLastActivity` *is* real).
|
||||
- Rotation order: mint → rewrite **both** stores (`~/.config/secrets/jellyfin`
|
||||
and `JELLYFIN_API_KEY` in the ignored `dankserver/.env`) → prove the new key on
|
||||
`/System/Info` → `DELETE` the old token → prove `401`. Revoking while a store
|
||||
still holds that value breaks the scan door silently.
|
||||
- Blast radius as measured 2026-11-03: no repo script reads `JELLYFIN_API_KEY`;
|
||||
Seerr keeps a key of its own in its own DB (which of its two rows it uses was
|
||||
never confirmed), so revoke by token and never by app name.
|
||||
|
||||
## Big-screen theme (the TV)
|
||||
|
||||
`dankserver/jellyfin/theme/wmc/theme.css` is repo-owned and bind-mounted over the
|
||||
image's **Media Center** theme slot (the `Volume=` line in
|
||||
`dankserver/jellyfin/quadlet/jellyfin.container`). It exists for
|
||||
`danklivingroom`, which renders this server-served web app at 3840×2160 with no
|
||||
client-side scaling, so 14 px text arrives on a panel read from three metres.
|
||||
|
||||
The file is four rules, and its first line is the design:
|
||||
`@import url("../dark/theme.css")` pulls in the **live upstream** dark palette, so
|
||||
the repo never vendors a CSS snapshot and a Jellyfin image bump cannot strand one.
|
||||
That works because jellyfin-web applies a theme as
|
||||
`<link rel="stylesheet" href="themes/<id>/theme.css">` — a relative URL resolved
|
||||
against the CSS file, not the document. The size lives in one number:
|
||||
`--dank-big-screen-zoom` (1.75 ≈ three metres; 1.5 mild, 2.0 projector). `zoom` on
|
||||
the root element is the right lever: the card-grid code measures layout pixels, so
|
||||
fewer, larger columns are computed rather than overflow produced.
|
||||
|
||||
- **Adoption is per device, and it stays that way.** The theme a client renders
|
||||
comes from its own settings (localStorage first), so there is no server-side
|
||||
"everyone gets the big UI" knob. On the screen that wants it:
|
||||
**Display Settings → Theme → Media Center.** That is also the honest label —
|
||||
the dropdown names are compiled into the bundle, so a "Big Screen" entry will
|
||||
never appear; do not go looking for one.
|
||||
- The mount is `:ro` and the app only fetches the file, so the failure mode of a
|
||||
stale `@import` target is slightly wrong colors, never a dead web app.
|
||||
- **Editing the CSS needs no restart.** The bind hands out the host file's live
|
||||
bytes, so a changed zoom number is on screen at the next page load. The planner
|
||||
agrees by construction: only `dankserver/<svc>/quadlet/**` maps to a service, so
|
||||
a `theme/**`-only commit plans nothing — that is correct, not a gap to "fix",
|
||||
because restarting a media server for a font size is the wrong trade. Only the
|
||||
first deploy of the `Volume=` line restarts anything.
|
||||
- **Rollback is one line:** drop the `Volume=` and redeploy; nothing in the
|
||||
database records the theme, so no cleanup follows.
|
||||
|
||||
## See Also
|
||||
|
||||
- [[Plex]] — co-resident media server on the same volume
|
||||
|
||||
@@ -316,7 +316,7 @@ flowchart TD
|
||||
**User services** (root page), in section order:
|
||||
- **AI** — OpenWebUI, and the three LLM fleet cards (frank-dragoon, frank-archon, frank-zealot — status + docs link, no Open link).
|
||||
- **Web Apps** — SearXNG, Gitea, Copyparty, Marreta.
|
||||
- **Media Library Apps** — Calibre-Web, RomM, Plex, Jellyfin, Seerr.
|
||||
- **Media Library Apps** — Calibre-Web, RomM, Plex, Jellyfin, Seerr, Audiobookshelf (moved up from the admin page 2026-11-03, once Authentik SSO made it a household app).
|
||||
|
||||
**Admin services** (`/admin/`), in section order:
|
||||
- **Media Library Apps** — the *arr stack (Prowlarr, Sonarr, Radarr, Lidarr, Readarr), qBittorrent, and Tautulli — live on FrankBook-Pro and Dankserver, operator-only: no vhosts (Tautulli included), direct IP:port access only. See [[FrankBook-Pro]].
|
||||
@@ -324,6 +324,12 @@ flowchart TD
|
||||
- **AI** — Hermes, ComfyUI.
|
||||
- **Infrastructure** — Caddy, dnsmasq, Gluetun, and the low-level backends (mariadb, valkey, Postgres). The backends show status only. They get a link only where a UI is meaningful.
|
||||
|
||||
**The registry is the authority.** `shared/homepage/services.json` decides which
|
||||
page a card renders on (`category`), whether it shows a WIP badge instead of live
|
||||
status (`wip`), and whether it gets an Open link (`showLink` + `url`). The two
|
||||
lists above are a locator only; when they disagree with the registry, the page is
|
||||
the bug — fix the page.
|
||||
|
||||
## Layout
|
||||
|
||||
```
|
||||
|
||||
@@ -1,35 +0,0 @@
|
||||
{
|
||||
"host": "dankserver",
|
||||
"services": [
|
||||
{
|
||||
"name": "Homepage",
|
||||
"url": "/",
|
||||
"description": "This page. Password-protected service index.",
|
||||
"docs": "serverAppConfigs-docs/Infrastructure/Homepage.md"
|
||||
},
|
||||
{
|
||||
"name": "RomM",
|
||||
"url": "http://romm.franksdank.cloud",
|
||||
"description": "Retro game manager and player for the ROM collection.",
|
||||
"docs": "serverAppConfigs-docs/Dankserver/RomM.md"
|
||||
},
|
||||
{
|
||||
"name": "Copyparty",
|
||||
"url": "http://files.franksdank.cloud",
|
||||
"description": "High-speed file sharing and streaming server.",
|
||||
"docs": "serverAppConfigs-docs/Dankserver/Copyparty.md"
|
||||
},
|
||||
{
|
||||
"name": "Calibre-Web",
|
||||
"url": "http://books.franksdank.cloud",
|
||||
"description": "E-book library browser and reader.",
|
||||
"docs": "serverAppConfigs-docs/Dankserver/Calibre-Web.md"
|
||||
},
|
||||
{
|
||||
"name": "Plex",
|
||||
"url": "http://plex.franksdank.cloud/web/index.html",
|
||||
"description": "Media server (existing host service, proxied).",
|
||||
"docs": "serverAppConfigs-docs/Dankserver/Dankserver Stack.md"
|
||||
}
|
||||
]
|
||||
}
|
||||
@@ -56,6 +56,10 @@
|
||||
<a href="https://jelly.franksdank.cloud">Jellyfin</a>. Seerr is the front door —
|
||||
requests ride the VPN tunnel from there.</li>
|
||||
<li><strong>Books:</strong> <a href="https://books.franksdank.cloud">Calibre-Web</a> — the e-book library, with its own login.</li>
|
||||
<li><strong>Audiobooks:</strong> <a href="https://audiobooks.franksdank.cloud">Audiobookshelf</a> — the
|
||||
audiobook library. Same single sign-on as everything else: choose
|
||||
<strong>Continue with authentik</strong> and each listener keeps their own
|
||||
position.</li>
|
||||
<li><strong>Games:</strong> <a href="https://romm.franksdank.cloud">RomM</a> — ROM library and emulator collection.</li>
|
||||
<li><strong>Raw files:</strong> <a href="https://files.franksdank.cloud">Copyparty</a> — direct downloads and shares.</li>
|
||||
<li><strong>Search:</strong> <a href="https://search.franksdank.cloud">SearXNG</a> — metasearch, VPN-routed, no AI snoop. <details class="key-warn"><summary>⚠ privacy note</summary><div class="warn-body">Searches are obfuscated, not anonymous: SearXNG hides you from the upstream engines and the VPN tunnel hides the traffic from the LAN — but the upstream search API keys are tied to Frank’s identity. Don’t treat it as Tor.</div></details></li>
|
||||
@@ -109,6 +113,7 @@
|
||||
<li><strong>Best for:</strong> complex agentic tasks, programming, system administration, and "claw"-style personal agents.</li>
|
||||
<li><strong>Supervision:</strong> safe for autonomous, low-supervision use.</li>
|
||||
<li><strong>Warning:</strong> <details class="key-warn"><summary>⚠ uncensored model</summary><div class="warn-body">Uncensored model: output can include adult content, content that describes harmful, hateful, or illegal acts, content concerning “sensitive offensive cybersecurity topics”, and other output that may carry severe legal risk. Take this warning seriously — don’t ruin this server for everybody.</div></details></li>
|
||||
</ul>
|
||||
|
||||
<h2>frank-archon — the big one</h2>
|
||||
<ul>
|
||||
|
||||
@@ -110,13 +110,13 @@
|
||||
"name": "Jellyfin",
|
||||
"category": "user",
|
||||
"section": "Media Library Apps",
|
||||
"description": "Open source media server. Work in progress: not open to family users yet.",
|
||||
"url": "",
|
||||
"description": "Open source media server for the film and TV library: its own logins (no Authentik here), so ask Frank for an account.",
|
||||
"url": "http://jelly.franksdank.cloud",
|
||||
"docs": "",
|
||||
"probe": "192.168.0.235:8096",
|
||||
"method": "http",
|
||||
"wip": "down",
|
||||
"showLink": false,
|
||||
"wip": false,
|
||||
"showLink": true,
|
||||
"art": "/img/apps/jellyfin.svg"
|
||||
},
|
||||
{
|
||||
@@ -136,7 +136,7 @@
|
||||
"name": "Marreta",
|
||||
"category": "user",
|
||||
"section": "Web Apps",
|
||||
"description": "Clean, ad-free article reader. Paste any URL, get just the article.",
|
||||
"description": "Paywall sledgehammer: hand it an article URL and it drags the page back through the VPN with the paywall chrome, cookie wall and trackers stripped; a headless browser renders the JS-heavy ones. Best effort — hard paywalls and login walls still win.",
|
||||
"url": "http://marreta.franksdank.cloud",
|
||||
"docs": "",
|
||||
"probe": "127.0.0.1:8082",
|
||||
@@ -513,9 +513,9 @@
|
||||
},
|
||||
{
|
||||
"name": "Audiobookshelf",
|
||||
"category": "admin",
|
||||
"category": "user",
|
||||
"section": "Media Library Apps",
|
||||
"description": "Audiobook server for the entropy library: its own SQLite library, its own login, per-listener positions.",
|
||||
"description": "Audiobook server for the library: sign in with your Authentik account and every listener keeps their own position.",
|
||||
"url": "http://audiobooks.franksdank.cloud/audiobookshelf/",
|
||||
"docs": "",
|
||||
"probe": "192.168.0.235:8000",
|
||||
|
||||
Reference in new issue
Block a user