s8n cb95dce8bc Rename: tv.s8n.ru → nasflix.s8n.ru, jellyfin-stack → NASFLIX

- Domain: tv.s8n.ru retired (404). nasflix.s8n.ru live (302 → /web).
  Pi-hole local DNS updated. Traefik file-provider router rule + docker-label
  router rule both flipped. Jellyfin PublishedServerUrl env updated. Cert
  re-issued via Gandi DNS-01. Onyx /etc/hosts pin moved.
- Repo: forgejo PATCH /api/v1/repos rename. Local clone remote URL updated.
  All in-tree refs to tv.s8n.ru and jellyfin-stack swept (sed).
- Scope: TV Shows + Movies only. anime/, musicvideos/, home/, music/,
  docs-*/ libraries removed from canonical layout. Sections kept as
  reference for re-introduction.
- Branding LoginDisclaimer text updated to nasflix.s8n.ru.

2026-05-08 02:53:46 +01:00

5.9 KiB

Raw Blame History

Admin Guide — nasflix.s8n.ru

The single page that tells you what to do and where to read more. Anything not on this page lives in docs/ — links inline.

What's next on this deploy → ROADMAP.md.

Where things live

Thing	Where
Compose file	`docker-compose.yml` (this repo) → deployed at `nullstone:/opt/docker/jellyfin/`
Config + cache	`nullstone:/home/docker/jellyfin/{config,cache}/`
Media root	`nullstone:/home/user/media/{movies,tv}/`
Traefik route	`/opt/docker/traefik/config/jellyfin-test.yml` (file-provider — see docs/04 § routing-quirk)
Pi-hole DNS pin	`/opt/docker/pihole/etc-pihole/custom.list` → `192.168.0.100 nasflix.s8n.ru`
User wrapper	`bin/add-jellyfin-user.sh` (always use this)

Daily ops

Add a new user

Always use the wrapper. UI signup skips the canonical home layout + subtitle/audio prefs.

JELLYFIN_TOKEN=<admin-token> ./bin/add-jellyfin-user.sh <username> <password>

What it does → docs/04 § friend playbook. Why it exists (Jellyfin has no native global default) → see same doc.

Add new media

Drop source into /home/admin/Downloads/<show or movie>/ on onyx.
Run cleanup: strip junk per docs/07. Use bin/cleanup-import.sh once written; for now follow the rules in that doc by hand.
Normalize filenames per docs/08. Use bin/normalize.py once written.
Stage to /home/admin/staging-jelly-<title>/<canonical-name>/.
scp -r to nullstone:/home/user/media/<lib>/.
Trigger refresh: curl -X POST -H "Authorization: MediaBrowser Token=$TOKEN" https://nasflix.s8n.ru/Library/Refresh.
Verify: hit the URL, check artwork + titles + episode counts.
Only after confirmed working: delete the source download + the staging dir.

Naming + folder rules: docs/05.

Library not scraping right

Symptoms → fix:

Symptom	Cause	Fix doc
No posters / backdrops	`EnableInternetProviders=false` or wrong fetcher name	docs/01
Episode titles blank or filenames	Series has empty `ProviderIds` (never matched)	docs/02 § Identify flow
Wrong show matched	Auto-match picked sequel/reboot	docs/02 § locking the right show
Polish/wrong language	Library `PreferredMetadataLanguage` mismatch	docs/02 § language cascade

Subtitles not auto-downloading

→ docs/03 § OpenSubtitles plugin setup. Owner needs an opensubtitles.com account (NOT .org). Free tier = 20/day.

Theme broke after Jellyfin upgrade

ElegantFin imports from cdn.jsdelivr.net/gh/lscambo13/ElegantFin@main/... — auto-fixes itself most of the time. If the upstream theme breaks on a JF version bump, pin to a known-good tag. Procedure: docs/04 § maintenance.

Operational rules (these are non-negotiable)

Wrapper-only user creation. Don't create users in the Dashboard UI. Always run bin/add-jellyfin-user.sh so the layout + prefs are consistent. Doc 04.
Stage before import. Never drop raw downloads into /home/user/media/. Always clean + normalize first. Docs 05/07/08.
Verify before delete. Don't delete source downloads or old library entries until the new content is confirmed playing in the Jellyfin UI.
No bind-mount drift. If you change docker-compose.yml, commit + push to git.s8n.ru/s8n/NASFLIX in the same step. The repo is the source of truth for the deploy. Doc memory: feedback_always_commit_to_my_git.md.
No public DNS. nasflix.s8n.ru resolves only via Pi-hole locally. Do NOT add a Gandi A record. LAN-only is the threat model.

Reference docs (read on demand)

Doc	When to read
01-artwork-and-images	Artwork missing or wrong; want to install Fanart.tv
02-metadata-and-titles	Wrong show matched; bad titles; multi-episode files
03-subtitles	OpenSubtitles config; sidecar `.srt` naming; ffmpeg extraction
04-theming-and-users	Theme tweaks; multi-user policies; SyncPlay
05-file-structure-rules	What folder/filename to use for any new media
06-per-library-themes	Want Movies-as-Netflix vs Anime-as-Crunchyroll skins
07-pre-import-cleanup	What to strip from a download before import
08-filename-normalization	How to rename files into canonical form

Emergency rollback

Operation	Rollback
Bad CustomCss change	`curl -X POST .../System/Configuration/branding` with prior backup
Compose change broke startup	`git checkout HEAD~ docker-compose.yml && docker compose up -d`
Library scan loop stuck	Settings → Dashboard → Scheduled Tasks → cancel "Scan Media Library"
New media import wrong	Don't panic. The source download is still in `/home/admin/Downloads/`. Delete the bad import dir on nullstone, redo cleanup/normalize step

Current state (snapshot)

Library: TV Shows → Futurama (1999), S01–S04, 72 episodes + 9 featurettes, English audio, 1080p HEVC, locked to TMDB 615 / TVDB 73871 / IMDb tt0149460. Polish set deleted 2026-05-08.
Disk: nullstone /home 109G free
Theme: ElegantFin v25.12.31
Plugins: OpenSubtitles v20 (creds pending — see docs/03)
Users: s8n (admin), guest (non-admin, password 123, change recommended)
Home layout (per-user, applied to both): resume / resumeaudio / nextup / latestmedia (My Media tile row dropped)

Last verified: 2026-05-08

5.9 KiB Raw Blame History Unescape Escape