docs: create Netgrimoire/Pocket/Stash_Integration
This commit is contained in:
Administrator
John Smith
parent
ff9f5df5aa
commit
47402071b2
1 changed files with 741 additions and 0 deletions
741
Netgrimoire/Pocket/Stash_Integration.md
Normal file
741
Netgrimoire/Pocket/Stash_Integration.md
Normal file
|
|
@ -0,0 +1,741 @@
|
|||
---
|
||||
title: Pocket Clips
|
||||
description: Integrating Stash
|
||||
published: true
|
||||
date: 2026-02-20T04:48:11.191Z
|
||||
tags:
|
||||
editor: markdown
|
||||
dateCreated: 2026-02-20T04:48:11.191Z
|
||||
---
|
||||
|
||||
# Pocket Grimoire - Stash Integration Guide
|
||||
|
||||
**Adding Stash media library manager to Pocket Grimoire using ZFS replication**
|
||||
|
||||
---
|
||||
|
||||
## Overview
|
||||
|
||||
This guide extends the Pocket Grimoire deployment to include Stash, a powerful media library manager. The architecture uses ZFS replication to mirror Stash data from Netgrimoire (home) to Pocket Grimoire (travel), allowing:
|
||||
|
||||
- Full Stash browsing offline
|
||||
- All previews, thumbnails, and metadata available
|
||||
- Zero CPU load on Pi (no scanning/generation)
|
||||
- Automatic synchronization via existing sync jobs
|
||||
- Read-only operation on travel
|
||||
|
||||
**Key Principle:** Netgrimoire does all heavy lifting (scanning, preview generation), Pocket Grimoire just serves pre-generated content.
|
||||
|
||||
---
|
||||
|
||||
## Architecture
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────┐
|
||||
│ NETGRIMOIRE (Home - Heavy Lifting) │
|
||||
├─────────────────────────────────────────┤
|
||||
│ Stash Container: │
|
||||
│ - Full scanning │
|
||||
│ - Preview generation │
|
||||
│ - Scene detection │
|
||||
│ - Database writes │
|
||||
│ - All CPU/GPU intensive work │
|
||||
│ │
|
||||
│ ZFS Dataset: vault/stash │
|
||||
│ - Stash database │
|
||||
│ - Generated previews │
|
||||
│ - Thumbnails & sprites │
|
||||
│ - Scene markers │
|
||||
└─────────────────────────────────────────┘
|
||||
↓
|
||||
ZFS Send/Receive
|
||||
(via syncoid every 6 hours)
|
||||
↓
|
||||
┌─────────────────────────────────────────┐
|
||||
│ POCKET GRIMOIRE (Travel - Read Only) │
|
||||
├─────────────────────────────────────────┤
|
||||
│ Stash Container: │
|
||||
│ - Read-only mode │
|
||||
│ - No scanning │
|
||||
│ - No generation │
|
||||
│ - Just browse existing data │
|
||||
│ │
|
||||
│ ZFS Dataset: vaultpg/stash │
|
||||
│ - Mirrored from Netgrimoire │
|
||||
│ - Complete database replica │
|
||||
│ - All previews pre-generated │
|
||||
└─────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Storage Requirements
|
||||
|
||||
### On Netgrimoire
|
||||
```
|
||||
Database: 500MB - 2GB (depends on library size)
|
||||
Generated previews: 5GB - 50GB (depends on preview settings)
|
||||
Blobs/markers: 1GB - 10GB
|
||||
───────────────────────────────────────────────────────
|
||||
Total: 6.5GB - 62GB
|
||||
```
|
||||
|
||||
### On Pocket Grimoire
|
||||
```
|
||||
Same as Netgrimoire (full replica via ZFS)
|
||||
Stored on Vault SSD (vaultpg pool)
|
||||
```
|
||||
|
||||
### Sync Bandwidth
|
||||
- **Initial sync:** 10-30GB (1-2 hours on gigabit LAN)
|
||||
- **Incremental sync:** 50MB - 500MB per 6 hours (2-10 minutes)
|
||||
- **After adding 10 videos:** ~210MB (database + previews)
|
||||
|
||||
---
|
||||
|
||||
## Resource Impact
|
||||
|
||||
### Updated Resource Profile (With Stash)
|
||||
|
||||
**Idle:**
|
||||
```
|
||||
Wiki.js + PostgreSQL: ~250MB RAM
|
||||
Jellyfin (idle): ~150MB RAM
|
||||
Stash (read-only): ~200MB RAM # Much lighter than active Stash
|
||||
ZFS ARC: ~512MB RAM
|
||||
System: ~200MB RAM
|
||||
─────────────────────────────────────────
|
||||
Total: ~1.3GB / 8GB RAM ✓
|
||||
CPU: <10%
|
||||
Temperature: Cool
|
||||
```
|
||||
|
||||
**Browsing Stash:**
|
||||
```
|
||||
Stash (active): ~300MB RAM
|
||||
Other services: ~1.1GB RAM
|
||||
─────────────────────────────────────────
|
||||
Total: ~1.4GB / 8GB RAM ✓
|
||||
CPU: <15%
|
||||
Temperature: Cool to Warm
|
||||
```
|
||||
|
||||
**Media Playback + Stash Browsing:**
|
||||
```
|
||||
Jellyfin (serving): ~200MB RAM
|
||||
Stash (active): ~300MB RAM
|
||||
Wiki.js + PostgreSQL: ~250MB RAM
|
||||
ZFS ARC: ~512MB RAM
|
||||
System: ~200MB RAM
|
||||
─────────────────────────────────────────
|
||||
Total: ~1.5GB / 8GB RAM ✓
|
||||
Still plenty of headroom
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Installation: Netgrimoire (Home)
|
||||
|
||||
### 1. Create ZFS Datasets
|
||||
|
||||
```bash
|
||||
# On Netgrimoire
|
||||
sudo zfs create -o recordsize=16K vault/stash
|
||||
sudo zfs create -o recordsize=16K vault/stash/config # Database
|
||||
sudo zfs create -o recordsize=1M vault/stash/generated # Previews
|
||||
sudo zfs create -o recordsize=128K vault/stash/blobs # Scene markers
|
||||
sudo zfs create vault/stash/cache # Temporary (won't replicate)
|
||||
|
||||
# Set appropriate permissions
|
||||
sudo chown -R 1000:1000 /vault/stash
|
||||
```
|
||||
|
||||
**Why different recordsizes:**
|
||||
- **16K** for config (SQLite database performs best with small records)
|
||||
- **1M** for generated (large video preview files)
|
||||
- **128K** for blobs (medium-sized screenshots and markers)
|
||||
|
||||
### 2. Create Stash Docker Compose
|
||||
|
||||
```bash
|
||||
mkdir -p /srv/netgrimoire/stacks/stash
|
||||
nano /srv/netgrimoire/stacks/stash/docker-compose.yml
|
||||
```
|
||||
|
||||
```yaml
|
||||
services:
|
||||
stash:
|
||||
image: stashapp/stash:latest
|
||||
container_name: netgrimoire_stash
|
||||
environment:
|
||||
- STASH_STASH=/data/
|
||||
- STASH_GENERATED=/generated/
|
||||
- STASH_CACHE=/cache/
|
||||
- STASH_BLOBS=/blobs/
|
||||
- TZ=America/Chicago
|
||||
volumes:
|
||||
- /vault/stash/config:/root/.stash
|
||||
- /vault/stash/generated:/generated
|
||||
- /vault/stash/cache:/cache
|
||||
- /vault/stash/blobs:/blobs
|
||||
- /vault/media:/data:ro # Your media library (read-only)
|
||||
ports:
|
||||
- "9999:9999"
|
||||
restart: unless-stopped
|
||||
```
|
||||
|
||||
**Start Stash:**
|
||||
```bash
|
||||
cd /srv/netgrimoire/stacks/stash
|
||||
docker compose up -d
|
||||
```
|
||||
|
||||
### 3. Configure Stash
|
||||
|
||||
1. **Access Stash:**
|
||||
- Open browser: `http://netgrimoire.local:9999`
|
||||
- Complete initial setup wizard
|
||||
|
||||
2. **Add Library:**
|
||||
- Settings → Library
|
||||
- Add folder: `/data/library/movies` (or your media path)
|
||||
- Save
|
||||
|
||||
3. **Configure Previews:**
|
||||
- Settings → Tasks → Generate
|
||||
- Preview Generation: Enable
|
||||
- Preview Settings:
|
||||
- Video encoding: VP9 or H.264
|
||||
- Resolution: 720p (good quality, reasonable size)
|
||||
- Segment duration: 10 seconds
|
||||
- Generate image previews: Enable
|
||||
- Generate sprites: Enable
|
||||
|
||||
4. **Run Initial Scan:**
|
||||
- Tasks → Scan
|
||||
- Wait for completion (can take hours depending on library size)
|
||||
|
||||
5. **Generate Previews:**
|
||||
- Tasks → Generate → Generate Previews
|
||||
- This is CPU intensive - let run at home
|
||||
- Can take many hours depending on library size
|
||||
|
||||
6. **Optional: Scene Detection:**
|
||||
- Tasks → Generate → Auto Tag
|
||||
- Scene detection, performer matching, etc.
|
||||
- Very CPU intensive, run at home only
|
||||
|
||||
### 4. Take ZFS Snapshots (Optional but Recommended)
|
||||
|
||||
```bash
|
||||
# After initial scan and preview generation
|
||||
sudo zfs snapshot vault/stash/config@initial
|
||||
sudo zfs snapshot vault/stash/generated@initial
|
||||
sudo zfs snapshot vault/stash/blobs@initial
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Installation: Pocket Grimoire (Travel)
|
||||
|
||||
### 1. Create ZFS Datasets
|
||||
|
||||
```bash
|
||||
# On Pocket Grimoire
|
||||
sudo zfs create -o recordsize=16K vaultpg/stash
|
||||
sudo zfs create -o recordsize=16K vaultpg/stash/config
|
||||
sudo zfs create -o recordsize=1M vaultpg/stash/generated
|
||||
sudo zfs create -o recordsize=128K vaultpg/stash/blobs
|
||||
sudo zfs create vaultpg/stash/cache # Local cache only, not synced
|
||||
|
||||
# Set permissions
|
||||
sudo chown -R 1000:1000 /srv/vaultpg/stash
|
||||
```
|
||||
|
||||
### 2. Create Stash Docker Compose (Read-Only)
|
||||
|
||||
```bash
|
||||
mkdir -p /srv/pocket-grimoire/stacks/stash
|
||||
nano /srv/pocket-grimoire/stacks/stash/docker-compose.yml
|
||||
```
|
||||
|
||||
```yaml
|
||||
services:
|
||||
stash:
|
||||
image: stashapp/stash:latest
|
||||
container_name: pocketgrimoire_stash
|
||||
environment:
|
||||
- STASH_STASH=/data/
|
||||
- STASH_GENERATED=/generated/
|
||||
- STASH_CACHE=/cache/
|
||||
- STASH_BLOBS=/blobs/
|
||||
- TZ=America/Chicago
|
||||
volumes:
|
||||
- /srv/vaultpg/stash/config:/root/.stash:ro # READ-ONLY
|
||||
- /srv/vaultpg/stash/generated:/generated:ro # READ-ONLY
|
||||
- /srv/vaultpg/stash/blobs:/blobs:ro # READ-ONLY
|
||||
- /srv/pocket-grimoire/data/stash/cache:/cache # Local cache (writable)
|
||||
- /srv/mediapg:/data:ro # Media (already present, read-only)
|
||||
ports:
|
||||
- "9999:9999"
|
||||
restart: unless-stopped
|
||||
```
|
||||
|
||||
**Note the `:ro` flags** - Filesystem is mounted read-only, preventing any writes.
|
||||
|
||||
**Start Stash:**
|
||||
```bash
|
||||
cd /srv/pocket-grimoire/stacks/stash
|
||||
docker compose up -d
|
||||
```
|
||||
|
||||
### 3. Configure Stash for Read-Only Operation
|
||||
|
||||
**After first start:**
|
||||
|
||||
1. **Access Stash:**
|
||||
- Open browser: `http://pocket-grimoire.local:9999`
|
||||
- Should show library from Netgrimoire (after first sync)
|
||||
|
||||
2. **Disable Background Tasks:**
|
||||
- Settings → Tasks
|
||||
- Disable all automatic tasks:
|
||||
- ❌ Auto-scan
|
||||
- ❌ Auto-tag
|
||||
- ❌ Auto-preview generation
|
||||
- ❌ Auto-cleanup
|
||||
|
||||
3. **Verify Read-Only:**
|
||||
- Try to edit a scene or performer
|
||||
- Should fail with permission error
|
||||
- This confirms read-only mode working
|
||||
|
||||
---
|
||||
|
||||
## ZFS Replication Configuration
|
||||
|
||||
### Update Sync Script
|
||||
|
||||
Edit your existing sync script to include Stash datasets:
|
||||
|
||||
```bash
|
||||
sudo nano /usr/local/sbin/pocketgrimoire-zfs-pull.sh
|
||||
```
|
||||
|
||||
Add these lines:
|
||||
|
||||
```bash
|
||||
#!/usr/bin/env bash
|
||||
set -euo pipefail
|
||||
|
||||
SRC_HOST="netgrimoire.local"
|
||||
SSH_KEY="/srv/pocket-grimoire/keys/zfs_pull_ro"
|
||||
|
||||
# Existing vault data syncs...
|
||||
syncoid --no-sync-snap --recursive \
|
||||
--sshkey "${SSH_KEY}" \
|
||||
"root@${SRC_HOST}:vault/docs" \
|
||||
"vaultpg/mirror/docs"
|
||||
|
||||
syncoid --no-sync-snap --recursive \
|
||||
--sshkey "${SSH_KEY}" \
|
||||
"root@${SRC_HOST}:vault/photos" \
|
||||
"vaultpg/mirror/photos"
|
||||
|
||||
# NEW: Stash database and generated content
|
||||
syncoid --no-sync-snap \
|
||||
--sshkey "${SSH_KEY}" \
|
||||
"root@${SRC_HOST}:vault/stash/config" \
|
||||
"vaultpg/stash/config"
|
||||
|
||||
syncoid --no-sync-snap \
|
||||
--sshkey "${SSH_KEY}" \
|
||||
"root@${SRC_HOST}:vault/stash/generated" \
|
||||
"vaultpg/stash/generated"
|
||||
|
||||
syncoid --no-sync-snap \
|
||||
--sshkey "${SSH_KEY}" \
|
||||
"root@${SRC_HOST}:vault/stash/blobs" \
|
||||
"vaultpg/stash/blobs"
|
||||
|
||||
# Note: We skip cache dataset (temporary data, not needed on Pocket)
|
||||
```
|
||||
|
||||
**Sync runs automatically every 6 hours** via existing systemd timer.
|
||||
|
||||
### Manual Sync (For Testing)
|
||||
|
||||
```bash
|
||||
# Trigger sync immediately
|
||||
sudo systemctl start pocketgrimoire-sync.service
|
||||
|
||||
# Watch progress
|
||||
tail -f /var/log/pocketgrimoire-sync.log
|
||||
|
||||
# Verify Stash data synced
|
||||
ls -lh /srv/vaultpg/stash/config
|
||||
ls -lh /srv/vaultpg/stash/generated
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Media Path Consistency
|
||||
|
||||
**Critical:** Media paths must be consistent between Netgrimoire and Pocket Grimoire.
|
||||
|
||||
### Option 1: Matching Paths
|
||||
|
||||
**If your media is in same location:**
|
||||
```
|
||||
Netgrimoire: /vault/media/library/
|
||||
Pocket: /srv/mediapg/library/
|
||||
```
|
||||
|
||||
**Stash stores absolute paths** - ensure they match or use symlinks.
|
||||
|
||||
### Option 2: Symlinks
|
||||
|
||||
```bash
|
||||
# On Pocket Grimoire
|
||||
sudo ln -s /srv/mediapg /vault/media
|
||||
```
|
||||
|
||||
This makes `/vault/media` point to `/srv/mediapg`, matching Netgrimoire's paths.
|
||||
|
||||
### Option 3: Stash Path Mapping (If Stash supports it)
|
||||
|
||||
Some versions of Stash support path mapping in config. Check Stash documentation.
|
||||
|
||||
---
|
||||
|
||||
## Workflow
|
||||
|
||||
### At Home (Before Trips)
|
||||
|
||||
**On Netgrimoire:**
|
||||
1. Add new media to library
|
||||
2. Stash auto-scans (or trigger manually)
|
||||
3. Previews generate automatically (or trigger manually)
|
||||
4. Tag/organize content as desired
|
||||
5. Everything happens in background
|
||||
|
||||
**Pocket Grimoire (automatic):**
|
||||
1. Every 6 hours: syncoid pulls changes from Netgrimoire
|
||||
2. Stash database updated
|
||||
3. New previews synced
|
||||
4. Scene markers updated
|
||||
5. Ready for next trip - no manual intervention
|
||||
|
||||
### While Traveling
|
||||
|
||||
**On Pocket Grimoire:**
|
||||
1. Access Stash: `http://pocket-grimoire.local:9999`
|
||||
2. Browse library, tags, performers, studios
|
||||
3. View previews and scene markers
|
||||
4. Click to play via Jellyfin or external player
|
||||
5. **Cannot:** Scan, edit tags, generate previews (read-only)
|
||||
|
||||
**If you need to edit:**
|
||||
1. VPN back to Netgrimoire (via WireGuard)
|
||||
2. Access Netgrimoire Stash: `http://netgrimoire.local:9999`
|
||||
3. Make changes there
|
||||
4. Changes sync on next 6-hour cycle
|
||||
|
||||
### After Returning Home
|
||||
|
||||
1. Sync happens automatically
|
||||
2. Any changes made on Netgrimoire while away are pulled
|
||||
3. Pocket Grimoire stays up-to-date
|
||||
4. No manual intervention required
|
||||
|
||||
---
|
||||
|
||||
## Accessing Stash
|
||||
|
||||
### From Onn Streaming Boxes
|
||||
|
||||
**Install StashApp for Android TV:**
|
||||
- See "Onn 4K Streaming Box Setup Guide" for detailed instructions
|
||||
- Download APK from: https://github.com/damontecres/StashAppAndroidTV/releases
|
||||
- Sideload onto Onn boxes
|
||||
- Configure server: `http://pocket-grimoire.local:9999`
|
||||
|
||||
### From Laptop
|
||||
|
||||
**Via Web Browser:**
|
||||
- Open: `http://pocket-grimoire.local:9999`
|
||||
- Full Stash web interface available
|
||||
- Same as Netgrimoire, but read-only
|
||||
|
||||
### From Phone/Tablet
|
||||
|
||||
**Via Web Browser:**
|
||||
- Connect to portapotty WiFi
|
||||
- Open: `http://pocket-grimoire.local:9999`
|
||||
- Mobile-responsive interface
|
||||
|
||||
---
|
||||
|
||||
## Updated Service Access Summary
|
||||
|
||||
**When connected to portapotty network:**
|
||||
|
||||
```
|
||||
Wiki.js: http://pocket-grimoire.local:3000
|
||||
Jellyfin: http://pocket-grimoire.local:8096
|
||||
Stash: http://pocket-grimoire.local:9999 ← NEW
|
||||
File Browser: http://pocket-grimoire.local:8080
|
||||
Dozzle: http://pocket-grimoire.local:8888
|
||||
SSH: ssh user@pocket-grimoire.local
|
||||
NFS Media: nfs://pocket-grimoire.local/srv/mediapg
|
||||
Router Admin: http://192.168.8.1
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### Stash Won't Start
|
||||
|
||||
**Check Docker container status:**
|
||||
```bash
|
||||
docker ps | grep stash
|
||||
docker logs pocketgrimoire_stash
|
||||
```
|
||||
|
||||
**Common issues:**
|
||||
- ZFS datasets not mounted: `zfs mount -a`
|
||||
- Permission denied: `sudo chown -R 1000:1000 /srv/vaultpg/stash`
|
||||
- Port conflict: Another service using port 9999
|
||||
|
||||
### Stash Shows "Database is locked"
|
||||
|
||||
**This means read-only mode is working correctly.**
|
||||
|
||||
If you need to make changes:
|
||||
1. VPN to Netgrimoire
|
||||
2. Edit on Netgrimoire Stash
|
||||
3. Changes sync to Pocket on next cycle
|
||||
|
||||
### Previews Not Showing
|
||||
|
||||
**Verify previews synced:**
|
||||
```bash
|
||||
ls /srv/vaultpg/stash/generated/
|
||||
# Should show many .webp or .mp4 files
|
||||
```
|
||||
|
||||
**If empty:**
|
||||
- Previews not generated on Netgrimoire yet
|
||||
- Sync hasn't completed (check sync logs)
|
||||
- Check: `tail -n 200 /var/log/pocketgrimoire-sync.log`
|
||||
|
||||
### Media Files Not Found
|
||||
|
||||
**Check paths match:**
|
||||
```bash
|
||||
# On Netgrimoire, Stash sees files at:
|
||||
# /vault/media/library/movies/
|
||||
|
||||
# On Pocket, files are at:
|
||||
# /srv/mediapg/library/movies/
|
||||
|
||||
# Create symlink to match:
|
||||
sudo ln -s /srv/mediapg /vault/media
|
||||
```
|
||||
|
||||
**Or verify Docker volume mount:**
|
||||
```bash
|
||||
docker inspect pocketgrimoire_stash | grep -A 10 Mounts
|
||||
# Should show /srv/mediapg mounted as /data
|
||||
```
|
||||
|
||||
### Sync Takes Too Long
|
||||
|
||||
**Check what's being synced:**
|
||||
```bash
|
||||
# Watch sync in progress
|
||||
sudo zfs list -t snapshot | grep stash
|
||||
|
||||
# Check dataset sizes
|
||||
sudo zfs list | grep stash
|
||||
```
|
||||
|
||||
**Optimization:**
|
||||
- Reduce preview quality on Netgrimoire (smaller files)
|
||||
- Sync less frequently (change timer from 6h to 12h)
|
||||
- Only sync when on fast network (manual trigger)
|
||||
|
||||
### Stash API Key Issues
|
||||
|
||||
**If StashApp asks for API key:**
|
||||
|
||||
1. **Find API key on Netgrimoire:**
|
||||
```bash
|
||||
# On Netgrimoire
|
||||
cat /vault/stash/config/config.yml | grep api_key
|
||||
```
|
||||
|
||||
2. **Or via Stash web UI:**
|
||||
- Settings → Security → API Key
|
||||
- Generate key if not present
|
||||
- Copy key
|
||||
|
||||
3. **Configure StashApp:**
|
||||
- Settings → Server → API Key
|
||||
- Paste key from Netgrimoire
|
||||
|
||||
**Note:** API key is in config, which syncs to Pocket, so should be the same.
|
||||
|
||||
---
|
||||
|
||||
## Optimization Tips
|
||||
|
||||
### Reduce Storage Usage
|
||||
|
||||
**On Netgrimoire (affects Pocket via sync):**
|
||||
|
||||
1. **Lower preview quality:**
|
||||
- Settings → Tasks → Generate
|
||||
- Video resolution: 480p instead of 720p
|
||||
- Lower bitrate
|
||||
- Smaller file sizes = faster sync
|
||||
|
||||
2. **Disable sprite generation:**
|
||||
- Settings → Tasks → Generate
|
||||
- Disable sprite generation (just use video previews)
|
||||
- Saves significant space
|
||||
|
||||
3. **Limit preview duration:**
|
||||
- Settings → Tasks → Generate
|
||||
- Preview duration: 20 seconds instead of 60 seconds
|
||||
- Smaller files
|
||||
|
||||
### Speed Up Sync
|
||||
|
||||
**Initial sync optimization:**
|
||||
```bash
|
||||
# First sync: Compress during transfer
|
||||
syncoid --compress=lz4 \
|
||||
--sshkey "${SSH_KEY}" \
|
||||
"root@${SRC_HOST}:vault/stash/generated" \
|
||||
"vaultpg/stash/generated"
|
||||
```
|
||||
|
||||
**Bandwidth limiting (if needed):**
|
||||
```bash
|
||||
# Limit to 10MB/s
|
||||
syncoid --bwlimit=10M \
|
||||
--sshkey "${SSH_KEY}" \
|
||||
"root@${SRC_HOST}:vault/stash/config" \
|
||||
"vaultpg/stash/config"
|
||||
```
|
||||
|
||||
### Reduce Preview Generation Load
|
||||
|
||||
**On Netgrimoire:**
|
||||
- Generate previews during off-hours (nightly)
|
||||
- Use Task Scheduler in Stash
|
||||
- Limit concurrent preview generation
|
||||
- Lower thread count for generation
|
||||
|
||||
---
|
||||
|
||||
## Maintenance
|
||||
|
||||
### Weekly
|
||||
|
||||
**On Netgrimoire:**
|
||||
- Check Stash is running: `docker ps | grep stash`
|
||||
- Verify previews generating (if auto-enabled)
|
||||
- Check disk usage: `zfs list | grep stash`
|
||||
|
||||
**On Pocket Grimoire:**
|
||||
- Verify sync is working: `tail /var/log/pocketgrimoire-sync.log`
|
||||
- Check Stash is accessible: `http://pocket-grimoire.local:9999`
|
||||
|
||||
### Monthly
|
||||
|
||||
**On Netgrimoire:**
|
||||
- Run manual scan if auto-scan disabled
|
||||
- Clean up orphaned files: Tasks → Clean
|
||||
- Check database integrity: Tasks → Optimize Database
|
||||
- ZFS scrub: `sudo zfs scrub vault/stash`
|
||||
|
||||
**On Pocket Grimoire:**
|
||||
- Verify dataset health: `sudo zpool status vaultpg`
|
||||
- Check sync logs for errors
|
||||
- Test Stash browsing and preview playback
|
||||
|
||||
### Before Trips
|
||||
|
||||
- [ ] Run scan on Netgrimoire (capture new content)
|
||||
- [ ] Generate previews for new content
|
||||
- [ ] Verify sync completed successfully
|
||||
- [ ] Test Stash on Pocket Grimoire
|
||||
- [ ] Verify StashApp on Onn boxes connects
|
||||
|
||||
### After Trips
|
||||
|
||||
- Check sync logs for any errors during trip
|
||||
- No action needed - sync continues automatically
|
||||
|
||||
---
|
||||
|
||||
## Alternative: Manual Database Export (Not Recommended)
|
||||
|
||||
**If ZFS replication is not available:**
|
||||
|
||||
You can manually export/import Stash database:
|
||||
|
||||
```bash
|
||||
# On Netgrimoire - Export
|
||||
sqlite3 /vault/stash/config/stash-go.sqlite ".backup /tmp/stash-backup.db"
|
||||
scp /tmp/stash-backup.db pocket-grimoire:/tmp/
|
||||
|
||||
# On Pocket Grimoire - Import
|
||||
docker compose down
|
||||
cp /tmp/stash-backup.db /srv/vaultpg/stash/config/stash-go.sqlite
|
||||
docker compose up -d
|
||||
```
|
||||
|
||||
**Why this is not recommended:**
|
||||
- Manual process (error-prone)
|
||||
- Doesn't sync previews/blobs automatically
|
||||
- Must copy those separately (tens of GB)
|
||||
- ZFS replication is much cleaner
|
||||
|
||||
---
|
||||
|
||||
## Summary
|
||||
|
||||
**What you get with Stash on Pocket Grimoire:**
|
||||
- ✅ Full Stash browsing offline
|
||||
- ✅ All previews and metadata available
|
||||
- ✅ Zero CPU load on Pi (read-only)
|
||||
- ✅ Automatic synchronization
|
||||
- ✅ Professional media library management
|
||||
- ✅ Scene markers and performer tagging
|
||||
- ✅ Works with StashApp on Onn boxes
|
||||
|
||||
**What you give up:**
|
||||
- ❌ Cannot edit/tag while traveling (must VPN to Netgrimoire)
|
||||
- ❌ Cannot generate previews on travel (shouldn't anyway)
|
||||
- ❌ 10-30GB additional storage on Vault SSD
|
||||
- ❌ Slightly more complex setup (but worth it)
|
||||
|
||||
**Recommended for:**
|
||||
- Large media libraries that need organization
|
||||
- Users who want professional media management
|
||||
- Those who already use or want to use Stash
|
||||
- Anyone who values rich metadata and previews
|
||||
|
||||
**Skip if:**
|
||||
- Just want simple media playback (Jellyfin is enough)
|
||||
- Very limited storage on Vault SSD
|
||||
- Don't want complexity of ZFS replication
|
||||
- Don't need tagging/scene detection features
|
||||
|
||||
---
|
||||
|
||||
*This guide supplements the main Pocket Grimoire deployment guide. Ensure main guide is completed before adding Stash.*
|
||||
Loading…
Add table
Add a link
Reference in a new issue