Initial commit: Claude project knowledge documents

Infrastructure, media, photos, and networking project knowledge files used as reference context for Claude Code sessions. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-09 13:28:41 -05:00
commit 6d3269f54c
5 changed files with 576 additions and 0 deletions
@@ -0,0 +1,82 @@
+# Photos — Project Knowledge
+
+## Storage
+- **NFS source**: `/mnt/big-11t/photos` on Proxmox host (jg-hud, 192.168.88.25)
+- NFS exported to:
+  - Photos/VM113 (`192.168.88.32`) — mounted as `/mnt/photos`
+  - ThinkStation (`192.168.88.41`) — mounted as `/mnt/photos`
+- Systemd mount units on both hosts with `network-online.target` dependency (fixes boot-time NFS failures)
+- Folder structure:
+  - `/mnt/photos/joe` — Joe's photos (organized by year: 1972, 1997, 1998...)
+  - `/mnt/photos/cynthia` — Cynthia's photos (organized by named folders)
+
+## PhotoPrism
+- URL: `https://photos.jgitta.com`
+- Host: **VM113 / photos** (192.168.88.32), port 2342
+- Compose: `/srv/docker/photoprism/docker-compose.yml`
+- Admin credentials: `admin` / `Jogiocsi1211+`
+- Database: MariaDB 11 (container: photoprism-db)
+  - DB: `photoprism`, user: `photoprism`, pass: `photoprism_db_pass`, root: `photoprism_root_pass`
+- Volumes (all bind mounts):
+  - `/mnt/photos/joe` → `/photoprism/originals/joe`
+  - `/mnt/photos/cynthia` → `/photoprism/originals/cynthia`
+  - Storage: `/srv/docker/photoprism/storage_data` → `/photoprism/storage`
+  - DB data: `/srv/docker/photoprism/db_data` → `/var/lib/mysql`
+- Mode: **Shared library, single login** (Option B)
+  - Browse Joe vs Cynthia separately via **Library → Folders** in the UI
+  - Timeline/Browse view shows all photos mixed by date (normal behaviour)
+- READONLY: `false` — deletions remove actual files from disk (rely on PBS backups)
+- Face detection: enabled (TensorFlow) — slows initial indexing significantly
+- Migrated from Siklos (VM112) to VM113: April 2026
+- Site URL in config: `https://photos.jgitta.com/`
+
+## Immich
+- URL: `https://pictures.jgitta.com`
+- Host: **VM113 / photos** (192.168.88.32), port 2283
+- Compose: `/srv/docker/immich/`
+- External libraries:
+  - `/mnt/photos/joe`
+  - `/mnt/photos/cynthia`
+- Database: PostgreSQL (pgvecto-rs) — data at `/srv/docker/immich/postgres/`
+- Library data: `/srv/docker/immich/library/`
+- Machine learning: enabled (separate container)
+- Migrated from Siklos (VM112) to VM113: April 2026
+
+## digiKam
+- Installed on ThinkStation (192.168.88.41) as AppImage
+- Used for photo editing and organisation
+- Collections configured under Settings → Configure digiKam → Collections
+- Fingerprints generated via Tools → Maintenance → Finger Prints
+- Accesses photos over NFS at `/mnt/photos`
+- Scanning over NFS is slower than local — disable system sleep for large scans
+
+## Duplicate Detection
+- `fdupes` — command line, byte-level duplicate detection
+  - `-f` flag useful: omit first directory (compare master vs secondary)
+  - `-r` recursive, `-d -N` auto-delete
+- `dupeGuru` — GUI alternative (`sudo apt install dupeguru`)
+  - Picture Mode for visually similar image matching
+  - Safer review-before-delete workflow
+
+## Caddy Entry (on CT202)
+File: `/etc/caddy/sites/media.caddy`
+```
+photos.jgitta.com {
+    import web_secure
+    reverse_proxy 192.168.88.32:2342 {
+        import proxy_timeouts
+    }
+}
+
+pictures.jgitta.com {
+    import web_secure
+    reverse_proxy 192.168.88.32:2283 {
+        import proxy_timeouts
+    }
+}
+```
+
+## Notes
+- PhotoPrism initial indexing with face detection can take several hours for large collections
+- After indexing, Joe and Cynthia folders visible under Library → Folders in PhotoPrism UI
+- Cloudflare DNS A record for `photos.jgitta.com` → `184.170.161.177` (proxied)