Erich Blume b8104d75ad Move zk cards to docs/zk/ for documentation restructuring (#84 )

## Summary
- Move all existing zettelkasten cards from `docs/` to `docs/zk/` as a temporary holding area
- Update `zk-docs` mise task to look in the new location
- Add `docs/README.md` explaining the Diataxis-based restructuring plan and target audiences

## Context
This is phase 1 of a multi-phase documentation restructuring effort. The goal is to reorganize docs to follow the Diataxis framework while serving multiple audiences:
1. Erich (owner) - knowledge graph/zk
2. Claude/AI agents - memory and context enrichment
3. New external readers - high-level overview
4. Potential operators/contributors - onboarding
5. Replicators - people wanting to duplicate the approach

## Testing
- [x] Verified `mise run zk-docs` still works with the new path
- [x] Updated obsidian.nvim config (in ~/.config/nvim) to point to new path

## Note
The obsidian.nvim config change is outside this repo but was made as part of this work.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Reviewed-on: https://forge.ops.eblu.me/eblume/blumeops/pulls/84

2026-02-03 09:13:50 -08:00

2.5 KiB

Raw Blame History

aliases

Jellyfin Management Log

Jellyfin is a free, open-source media server running natively on indri for full VideoToolbox hardware transcoding support.

Service Details

URL: https://jellyfin.ops.eblu.me
Port: 8096 (localhost only, proxied via Caddy)
Data directory: ~/Library/Application Support/jellyfin
Media path: /Volumes/allisonflix (NFS from sifaka)
LaunchAgent: mcquack.jellyfin

Useful Commands

# Check LaunchAgent status
ssh indri 'launchctl list | grep jellyfin'

# View logs
ssh indri 'tail -f ~/Library/Logs/mcquack.jellyfin.err.log'

# Check port is listening
ssh indri 'lsof -nP -iTCP:8096 -sTCP:LISTEN'

# Restart Jellyfin
ssh indri 'launchctl unload ~/Library/LaunchAgents/mcquack.jellyfin.plist && launchctl load ~/Library/LaunchAgents/mcquack.jellyfin.plist'

# Check metrics
ssh indri 'cat /opt/homebrew/var/node_exporter/textfile/jellyfin.prom'

Hardware Transcoding

Jellyfin uses Apple VideoToolbox for hardware-accelerated transcoding on the M1 Mac Mini.

Capabilities:

H.264 encode/decode: Hardware
HEVC (H.265) encode/decode: Hardware
AV1 decode: Software only (requires M3+)
HDR to SDR tone mapping: VPP (hardware)
Concurrent 4K streams: ~3 with HDR tonemapping

Configuration (Dashboard > Playback):

Hardware Acceleration: Apple VideoToolbox
Allow hardware encoding: Enabled
VPP Tone mapping: Enabled (for HDR to SDR)

Observability

Metrics: Collected via jellyfin_metrics ansible role to Prometheus textfile
Logs: Forwarded to Loki via Alloy (service="jellyfin")
Dashboard: "Jellyfin Media Server" in Grafana

Metrics collected:

jellyfin_up - Server availability
jellyfin_version_info - Server version
jellyfin_library_items{library,type} - Library counts
jellyfin_sessions_total - Active sessions
jellyfin_sessions_playing - Playing sessions
jellyfin_transcode_sessions_total - Transcoding sessions

API Key Setup

Metrics collection requires an API key:

Open https://jellyfin.ops.eblu.me
Go to Dashboard > API Keys > Add
Create key with description "metrics"
Save to indri:

ssh indri 'echo "YOUR_API_KEY" > ~/.jellyfin-api-key && chmod 600 ~/.jellyfin-api-key'

Log

2026-01-30 (Initial Deployment)

Deployed Jellyfin natively on indri via Ansible
Installed via Homebrew cask, managed via LaunchAgent
Added Caddy routing for jellyfin.ops.eblu.me
Added metrics collection (jellyfin_metrics role)
Added log collection via Alloy
Created Grafana dashboard

2.5 KiB Raw Blame History