traveler/Netgrimoire
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs: update Netgrimoire/Pocket/Stash_Integration

Browse source
This commit is contained in:
Administrator 2026-02-22 05:20:32 +00:00 • committed by John Smith
parent 5404b15726
commit 27e5bd0788
1 changed files with 44 additions and 33 deletions
Download patch file Download diff file Expand all files Collapse all files

77
Netgrimoire/Pocket/Stash_Integration.md
View file

@ -2,7 +2,7 @@
title: Pocket Clips title: Pocket Clips
description: Integrating Stash description: Integrating Stash
published: true published: true
date: 2026-02-21T06:11:15.579Z date: 2026-02-22T05:20:21.030Z
tags: tags:
editor: markdown editor: markdown
dateCreated: 2026-02-20T04:48:11.191Z dateCreated: 2026-02-20T04:48:11.191Z
@ -50,8 +50,8 @@ This approach provides:
│ └─ Does NOT sync to Pocket │ │ └─ Does NOT sync to Pocket │
│ │ │ │
│ Stash Instance #2: "Stash-Pocket" (Port 9998) │ │ Stash Instance #2: "Stash-Pocket" (Port 9998) │
│ ├─ Watches: ONLY Green/media (personal content) │ │ ├─ Watches: ONLY Green/Pocket (personal content) │
│ ├─ Location: /export/vault/Green/ │ │ ├─ Location: /export/Green/Pocket/ │
│ │ ├── media/library/ (personal media) │ │ │ ├── media/library/ (personal media) │
│ │ └── stash/ (Stash-Pocket data) │ │ │ └── stash/ (Stash-Pocket data) │
│ │ ├── config/ (database) │ │ │ ├── config/ (database) │
@ -61,20 +61,21 @@ This approach provides:
│ └─ SYNCS to Pocket GREEN drive via ZFS │ │ └─ SYNCS to Pocket GREEN drive via ZFS │
│ │ │ │
└─────────────────────────────────────────────────────┘ └─────────────────────────────────────────────────────┘
↓ ZFS Send ↓ ZFS Send (syncoid)
(Entire /export/vault/Green/ syncs to GREEN drive) (vault/Green/Pocket → greenpg/Pocket)
↓ ↓
┌─────────────────────────────────────────────────────┐ ┌─────────────────────────────────────────────────────┐
│ POCKET GRIMOIRE (Travel) │ │ POCKET GRIMOIRE (Travel) │
├─────────────────────────────────────────────────────┤ ├─────────────────────────────────────────────────────┤
│ │ │ │
│ GREEN Drive (greenpg pool): │ │ GREEN Drive (greenpg pool): │
│ ├─ /srv/greenpg/media/library/ (media files) │ │ └─ /srv/greenpg/Pocket/ (dataset from sync) │
│ └─ /srv/greenpg/stash/ (Stash data) │ │ ├─ media/library/ (media files) │
│ └─ stash/ (Stash data) │
│ │ │ │
│ Stash Instance: "Stash-Pocket" (Port 9999) │ │ Stash Instance: "Stash-Pocket" (Port 9999) │
│ ├─ Watches: GREEN media only (read-only) │ │ ├─ Watches: GREEN media only (read-only) │
│ ├─ Location: /srv/greenpg/ │ │ ├─ Location: /srv/greenpg/Pocket/ │
│ │ ├── media/library/ (synced media) │ │ │ ├── media/library/ (synced media) │
│ │ └── stash/ (synced, read-only) │ │ │ └── stash/ (synced, read-only) │
│ │ ├── config/ (synced database) │ │ │ ├── config/ (synced database) │
@ -130,7 +131,7 @@ Total: ~56-225GB (stays on Netgrimoire)
**Stash-Pocket (DOES sync to GREEN drive):** **Stash-Pocket (DOES sync to GREEN drive):**
``` ```
Location: /export/vault/Green/stash/ Location: /export/Green/Pocket/stash/
Database: 200MB-1GB (smaller subset) Database: 200MB-1GB (smaller subset)
Generated previews: 5-20GB Generated previews: 5-20GB
Blobs/markers: 1-5GB Blobs/markers: 1-5GB
@ -140,16 +141,16 @@ Total: ~6-26GB (syncs to Pocket GREEN)
**Personal Media (syncs to GREEN drive):** **Personal Media (syncs to GREEN drive):**
``` ```
Location: /export/vault/Green/media/ Location: /export/Green/Pocket/media/
Content: 500GB-1TB (curated for travel) Content: 500GB-1TB (curated for travel)
───────────────────────────────────────────── ─────────────────────────────────────────────
Total Green data: ~506GB-1TB (entire /Green/ directory) Total Green/Pocket: ~506GB-1TB (vault/Green/Pocket dataset)
``` ```
### On Pocket Grimoire (GREEN Drive) ### On Pocket Grimoire (GREEN Drive)
``` ```
Location: /srv/greenpg/ Location: /srv/greenpg/Pocket/
Stash data: ~6-26GB (synced from Netgrimoire) Stash data: ~6-26GB (synced from Netgrimoire)
Media files: ~500GB-1TB (synced from Netgrimoire) Media files: ~500GB-1TB (synced from Netgrimoire)
───────────────────────────────────────────── ─────────────────────────────────────────────
@ -228,22 +229,32 @@ Still plenty of headroom
### 1. Create Directory Structure ### 1. Create Directory Structure
```bash ```bash
# Create Stash-Main directories (NOT in Pocket folder - won't sync) # Create Stash-Main directories (NOT in Green folder - won't sync)
sudo mkdir -p /export/vault/stash-main/{config,generated,blobs,cache} sudo mkdir -p /export/vault/stash-main/{config,generated,blobs,cache}
sudo chown -R 1000:1000 /export/vault/stash-main sudo chown -R 1000:1000 /export/vault/stash-main
sudo chmod -R 755 /export/vault/stash-main sudo chmod -R 755 /export/vault/stash-main
# Create Stash-Pocket directories (IN Pocket folder - will sync) # Stash-Pocket directories in existing Green/Pocket dataset
sudo mkdir -p /export/vault/Green/Pocket/stash/{config,generated,blobs,cache} # Your dataset: vault/Green/Pocket mounted at /export/Green/Pocket
sudo mkdir -p /export/vault/Green/Pocket/media/library/{movies,tv} sudo mkdir -p /export/Green/Pocket/stash/{config,generated,blobs,cache}
sudo chown -R 1000:1000 /export/vault/Green/Pocket sudo mkdir -p /export/Green/Pocket/media/library/{movies,tv}
sudo chmod -R 755 /export/vault/Green/Pocket sudo chown -R 1000:1000 /export/Green/Pocket
sudo chmod -R 755 /export/Green/Pocket
``` ```
**Verify structure:** **Verify structure:**
```bash ```bash
tree -L 2 /export/vault/stash-main tree -L 2 /export/vault/stash-main
tree -L 3 /export/vault/Green/Pocket tree -L 3 /export/Green/Pocket
# Should show:
# /export/Green/Pocket/
# ├── stash/
# │ ├── config/
# │ ├── generated/
# │ ├── blobs/
# │ └── cache/
# └── media/
# └── library/
``` ```
### 2. Curate Pocket Media Content ### 2. Curate Pocket Media Content
@ -543,16 +554,16 @@ services:
- STASH_BLOBS=/blobs/ - STASH_BLOBS=/blobs/
- TZ=America/Chicago - TZ=America/Chicago
volumes: volumes:
# Point to synced Pocket directory (READ-ONLY) # Point to synced Pocket directory on GREEN drive (READ-ONLY)
- /srv/vaultpg/Green/Pocket/stash/config:/root/.stash:ro - /srv/greenpg/Pocket/stash/config:/root/.stash:ro
- /srv/vaultpg/Green/Pocket/stash/generated:/generated:ro - /srv/greenpg/Pocket/stash/generated:/generated:ro
- /srv/vaultpg/Green/Pocket/stash/blobs:/blobs:ro - /srv/greenpg/Pocket/stash/blobs:/blobs:ro
# Local cache only (writable, not synced) # Local cache only (writable, not synced)
- /srv/pocket-grimoire/data/stash/cache:/cache - /srv/pocket-grimoire/data/stash/cache:/cache
# Media location (read-only) # Media location on GREEN drive (read-only)
- /srv/vaultpg/Green/Pocket/media:/data:ro - /srv/greenpg/Pocket/media:/data:ro
ports: ports:
- "9999:9999" # Standard port on Pocket (no conflict) - "9999:9999" # Standard port on Pocket (no conflict)
restart: unless-stopped restart: unless-stopped
@ -619,24 +630,24 @@ set -euo pipefail
SRC_HOST="netgrimoire.local" SRC_HOST="netgrimoire.local"
SSH_KEY="/srv/pocket-grimoire/keys/zfs_pull_ro" SSH_KEY="/srv/pocket-grimoire/keys/zfs_pull_ro"
# Existing sync - this now includes Stash-Pocket automatically # Sync vault/Green/Pocket to GREEN drive (greenpg/Pocket)
syncoid --no-sync-snap --recursive \ syncoid --no-sync-snap \
--sshkey "${SSH_KEY}" \ --sshkey "${SSH_KEY}" \
"root@${SRC_HOST}:vault/Green/Pocket" \ "root@${SRC_HOST}:vault/Green/Pocket" \
"vaultpg/Green/Pocket" "greenpg/Pocket"
# This single command syncs: # This single command syncs:
# - /export/vault/Green/Pocket/stash/ → Stash-Pocket data # - /export/Green/Pocket/stash/ → Stash-Pocket data
# - /export/vault/Green/Pocket/media/ → Media files # - /export/Green/Pocket/media/ → Media files
# - /export/vault/Green/Pocket/wiki/ → Wiki content # All Pocket data syncs to GREEN drive automatically
# - /export/vault/Green/Pocket/photos/ → Photos
# - /export/vault/Green/Pocket/documents/ → Documents
``` ```
**No additional sync commands needed!** ✅ **No additional sync commands needed!** ✅
**Stash-Main data does NOT sync** (it's in `/export/vault/stash-main/`, outside Pocket directory). **Stash-Main data does NOT sync** (it's in `/export/vault/stash-main/`, outside Pocket directory).
**Note:** The sync destination is `greenpg/Pocket` on the GREEN drive, NOT `vaultpg`. Stash and media data live on GREEN, not VAULT.
### Sync Frequency ### Sync Frequency
**Your existing timer:** Every 6 hours **Your existing timer:** Every 6 hours