docs: add all untracked content

This commit is contained in:
John Smith 2026-04-01 02:54:27 +00:00
parent 3268c2b2f7
commit 1a98eb6402
48 changed files with 145 additions and 48 deletions

View file

@ -2,7 +2,7 @@
title: Untitled Page
description:
published: true
date: 2026-04-01T01:56:02.958Z
date: 2026-04-01T01:56:08.260Z
tags:
editor: markdown
dateCreated: 2026-04-01T01:50:18.740Z

View file

@ -2,7 +2,7 @@
title: LDAP Client Setup
description:
published: true
date: 2026-01-22T03:36:37.380Z
date: 2026-02-20T04:33:31.862Z
tags:
editor: markdown
dateCreated: 2026-01-21T13:21:40.588Z

View file

@ -2,7 +2,7 @@
title: Immich Backup and Restore
description: Immich backup with Kopia
published: true
date: 2026-02-14T23:34:02.017Z
date: 2026-02-20T04:11:52.181Z
tags:
editor: markdown
dateCreated: 2026-02-14T03:14:32.594Z

View file

@ -2,7 +2,7 @@
title: Mailcow Backup and Restore Strategy
description: Mailcow backup
published: true
date: 2026-02-13T22:23:40.797Z
date: 2026-02-20T04:15:25.924Z
tags:
editor: markdown
dateCreated: 2026-02-11T01:20:59.127Z

View file

@ -2,7 +2,7 @@
title: Nextcloud Backup
description: Native + Kopia
published: true
date: 2026-02-18T04:40:14.455Z
date: 2026-02-20T04:19:28.405Z
tags:
editor: markdown
dateCreated: 2026-02-14T23:52:25.405Z

View file

@ -2,7 +2,7 @@
title: Services Backup
description:
published: true
date: 2026-02-14T23:51:09.146Z
date: 2026-02-20T04:08:15.923Z
tags:
editor: markdown
dateCreated: 2026-02-05T21:28:23.152Z

View file

@ -2,7 +2,7 @@
title: Wikijs Backup
description: Backup Wikijs
published: true
date: 2026-02-23T04:35:24.121Z
date: 2026-02-23T04:35:32.870Z
tags:
editor: markdown
dateCreated: 2026-02-23T04:35:24.121Z

View file

@ -2,7 +2,7 @@
title: Netgrimoire Documentation
description: How to create and use Netgrimoire Docs
published: true
date: 2026-02-03T02:54:56.444Z
date: 2026-02-20T04:16:19.329Z
tags:
editor: markdown
dateCreated: 2026-02-03T02:54:56.444Z

View file

@ -2,7 +2,7 @@
title: Documentation Style Guide
description: Applying a theme
published: true
date: 2026-02-25T21:32:08.276Z
date: 2026-02-25T21:32:16.786Z
tags:
editor: markdown
dateCreated: 2026-02-24T14:03:00.791Z

View file

@ -2,7 +2,7 @@
title: Port Assignments
description:
published: true
date: 2026-01-27T13:15:17.556Z
date: 2026-02-20T04:21:52.996Z
tags:
editor: markdown
dateCreated: 2026-01-27T03:42:58.945Z

View file

@ -2,7 +2,7 @@
title: Caddy Reverse Proxy
description: Curreent and future config
published: true
date: 2026-02-25T01:50:11.740Z
date: 2026-02-25T01:50:20.558Z
tags:
editor: markdown
dateCreated: 2026-02-23T22:09:16.106Z

View file

@ -2,7 +2,7 @@
title: OpnSense-IDS/IPS
description: IDS
published: true
date: 2026-02-23T21:51:41.041Z
date: 2026-02-23T21:51:49.920Z
tags:
editor: markdown
dateCreated: 2026-02-23T21:49:16.861Z

View file

@ -2,7 +2,7 @@
title: OpnSense - App Protection
description: App Inspection
published: true
date: 2026-02-23T21:52:34.981Z
date: 2026-02-23T21:52:43.630Z
tags:
editor: markdown
dateCreated: 2026-02-23T21:50:37.324Z

View file

@ -2,7 +2,7 @@
title: OpnSense
description: Grimoire Firewall Configuration
published: true
date: 2026-02-23T21:31:15.244Z
date: 2026-02-23T21:31:26.008Z
tags:
editor: markdown
dateCreated: 2026-02-23T21:31:15.244Z

View file

@ -2,7 +2,7 @@
title: OpnSense - GIT Integration
description: Git Integration
published: true
date: 2026-02-23T21:53:15.906Z
date: 2026-02-23T21:53:24.522Z
tags:
editor: markdown
dateCreated: 2026-02-23T21:48:01.779Z

View file

@ -2,7 +2,7 @@
title: OpnSense - NTFY Integration
description: Security Notifications
published: true
date: 2026-02-23T22:00:37.268Z
date: 2026-02-23T22:00:46.462Z
tags:
editor: markdown
dateCreated: 2026-02-23T22:00:37.268Z

View file

@ -2,7 +2,7 @@
title: Opnsense - Additional Blocklists
description: Blocklists
published: true
date: 2026-02-23T21:54:04.063Z
date: 2026-02-23T21:54:13.019Z
tags:
editor: markdown
dateCreated: 2026-02-23T21:46:39.562Z

View file

@ -2,7 +2,7 @@
title: Video Restoration Script
description: Restore VHS Video Captures
published: true
date: 2026-03-06T03:48:05.841Z
date: 2026-03-06T03:48:12.713Z
tags:
editor: markdown
dateCreated: 2026-03-06T03:48:05.841Z

View file

@ -2,7 +2,7 @@
title: Stashapp Workflow
description:
published: true
date: 2026-02-18T13:08:53.604Z
date: 2026-02-20T04:25:56.467Z
tags:
editor: markdown
dateCreated: 2026-02-18T13:08:53.604Z

View file

@ -2,7 +2,7 @@
title: Pocket Grimoire
description:
published: true
date: 2026-02-22T05:00:02.026Z
date: 2026-02-26T12:42:50.676Z
tags:
editor: markdown
dateCreated: 2026-02-20T04:41:35.122Z
@ -354,6 +354,23 @@ sudo raspi-config
# System Options → Locale → en_US.UTF-8
```
**⚠️ Important: Ubuntu Pi Boot Configuration Note**
Ubuntu on Raspberry Pi uses a different boot config location than Raspberry Pi OS.
The active kernel command line is in:
```
/boot/firmware/current/cmdline.txt
```
**Do NOT edit** `/boot/firmware/cmdline.txt` for kernel parameters — that file is only read during `tryboot` scenarios and is ignored on normal boot.
Any kernel parameters (including USB quirks for drives) must go in `/boot/firmware/current/cmdline.txt` as a single unbroken line.
This is critical for applying USB storage quirks (see Troubleshooting section if you experience drive issues).
---
### 2. Install VeraCrypt (Optional - For Encrypted Container Files)
**VeraCrypt** allows you to mount encrypted container files as virtual drives. This is useful for:
@ -2933,6 +2950,86 @@ sudo syncoid vault/Green/Pocket greenpg/Pocket # if greenpg
**Best practice:** After first import to Pocket, the pool is permanently `greenpg`
### Kanguru UltraLock UAS Errors / Pool Suspended
**Symptoms:**
- ZFS pool repeatedly suspending with `error=5` (EIO)
- dmesg showing `uas_eh_abort_handler` every ~30 seconds
- Pool status shows `SUSPENDED`
- Drive resets cycling: `uas_eh_device_reset_handler start/success` repeating
```
sd 0:0:0:0: [sda] tag#8 uas_eh_abort_handler 0 uas-tag 3 inflight: CMD IN
scsi host0: uas_eh_device_reset_handler start
scsi host0: uas_eh_device_reset_handler success
WARNING: Pool 'greenpg' has encountered an uncorrectable I/O failure and has been suspended.
```
**Root Cause:**
The Kanguru UltraLock (`idVendor=1e1d, idProduct=2001`) uses the UAS driver by default. The Raspberry Pi 4's xhci USB controller has a known incompatibility with UAS on certain drives. The fix is to force the drive to use the `usb-storage` driver instead via a kernel quirk parameter.
**Fix (Ubuntu Pi — permanent):**
```bash
# Edit the correct cmdline file (NOT /boot/firmware/cmdline.txt)
sudo nano /boot/firmware/current/cmdline.txt
```
Add `usb-storage.quirks=1e1d:2001:u` to the end of the existing single line:
```
console=serial0,115200 multipath=off dwc_otg.lpm_enable=0 console=tty1 root=LABEL=writable rootfstype=ext4 panic=10 rootwait fixrtc usb-storage.quirks=1e1d:2001:u
```
```bash
# Verify: should show ONE $ at end, no blank lines
cat -A /boot/firmware/current/cmdline.txt
# Reboot
sudo reboot
```
**Verify fix after reboot:**
```bash
sudo dmesg | grep -i "kanguru\|uas\|usb-storage" | head -10
```
Confirmed working output:
```
usb 2-2: UAS is ignored for this device, using usb-storage instead
usb-storage 2-2:1.0: USB Mass Storage device detected
usb-storage 2-2:1.0: Quirks match for vid 1e1d pid 2001: 800000
scsi host0: usb-storage 2-2:1.0
```
**Recover suspended pool after applying fix:**
```bash
sudo zpool clear greenpg
sudo zfs load-key greenpg/Pocket
sudo zfs mount -a
```
If pool has data errors from before the fix:
```bash
sudo zpool status -v greenpg
sudo zpool scrub greenpg
# If metadata errors remain and can't be repaired, destroy and resync from Netgrimoire
```
**Why `/boot/firmware/cmdline.txt` doesn't work:**
On Ubuntu Pi, `/boot/firmware/config.txt` only reads `cmdline=cmdline.txt` under the `[tryboot]` section. The active boot uses `/boot/firmware/current/cmdline.txt` instead. This differs from Raspberry Pi OS where `/boot/firmware/cmdline.txt` is the correct file.
**Hardware reference:**
- Kanguru UltraLock USB ID: `1e1d:2001`
- Pi 4 USB controller: xhci_hcd (Broadcom BCM2711)
- Issue: xhci + UAS incompatibility on large USB drives
*Fix discovered and documented during greenpg pool troubleshooting, February 2026*
### Docker Containers Not Starting
```bash
# Check if ZFS pools are mounted first

View file

@ -2,7 +2,7 @@
title: Pocket Grimoire - Hardware
description: Hardware for Pocket Grimoire
published: true
date: 2026-02-03T17:22:16.329Z
date: 2026-02-20T04:29:06.922Z
tags:
editor: markdown
dateCreated: 2026-01-28T23:07:03.685Z

View file

@ -2,7 +2,7 @@
title: Stream Box
description: Configure ONN Media Box
published: true
date: 2026-02-20T04:50:34.384Z
date: 2026-02-20T04:50:44.701Z
tags:
editor: markdown
dateCreated: 2026-02-20T04:50:34.384Z

View file

@ -2,7 +2,7 @@
title: Pocket Grimoire Software
description:
published: true
date: 2026-01-29T04:40:00.733Z
date: 2026-02-20T04:30:28.681Z
tags:
editor: markdown
dateCreated: 2026-01-29T04:37:33.794Z

View file

@ -2,7 +2,7 @@
title: Pocket Clips
description: Integrating Stash
published: true
date: 2026-02-22T05:20:21.030Z
date: 2026-02-22T05:20:31.865Z
tags:
editor: markdown
dateCreated: 2026-02-20T04:48:11.191Z

View file

@ -2,7 +2,7 @@
title: Service Documentation Template
description: Describe the service
published: true
date: 2026-02-03T02:57:07.462Z
date: 2026-02-20T04:24:03.727Z
tags:
editor: markdown
dateCreated: 2026-02-03T02:57:07.462Z

View file

@ -2,7 +2,7 @@
title: Ollama with agent
description: The smart home reference
published: true
date: 2026-03-05T02:26:34.682Z
date: 2026-03-05T02:26:41.506Z
tags:
editor: markdown
dateCreated: 2026-02-18T22:14:41.533Z

View file

@ -2,7 +2,7 @@
title: Readme
description: Readme file generated by AI
published: true
date: 2026-03-05T02:27:57.522Z
date: 2026-03-05T02:28:03.404Z
tags:
editor: markdown
dateCreated: 2026-03-05T02:27:57.522Z

View file

@ -2,7 +2,7 @@
title: Immich on ZFS
description: Moving Immich to its own ZFS dataset
published: true
date: 2026-02-06T15:57:04.261Z
date: 2026-02-20T04:13:02.502Z
tags: service zfs immich dataset
editor: markdown
dateCreated: 2026-02-06T15:57:04.261Z

View file

@ -2,7 +2,7 @@
title: Integrating MXRoute with MailCow
description:
published: true
date: 2026-02-25T21:04:26.849Z
date: 2026-02-25T21:04:37.135Z
tags:
editor: markdown
dateCreated: 2026-02-25T19:22:31.514Z

View file

@ -2,7 +2,7 @@
title: Mailcow Dockerized Install and Config
description:
published: true
date: 2026-02-25T21:05:38.864Z
date: 2026-02-25T21:05:48.256Z
tags:
editor: markdown
dateCreated: 2026-02-25T21:05:38.864Z

View file

@ -2,7 +2,7 @@
title: MailCow Hardening
description: Securing Mailcow
published: true
date: 2026-02-23T21:56:22.998Z
date: 2026-02-23T21:56:32.211Z
tags:
editor: markdown
dateCreated: 2026-02-23T21:56:22.997Z

View file

@ -2,7 +2,7 @@
title: Forwarding Mailcow through MXRoute
description: Maintaining reputation
published: true
date: 2026-02-15T01:42:12.478Z
date: 2026-02-20T04:10:37.730Z
tags:
editor: markdown
dateCreated: 2026-02-15T01:42:12.478Z

View file

@ -2,7 +2,7 @@
title: Sample Domain Setup
description: Graymutt@nucking-futz.com
published: true
date: 2026-03-16T00:34:02.401Z
date: 2026-03-16T00:34:08.387Z
tags:
editor: markdown
dateCreated: 2026-02-25T22:02:27.719Z

View file

@ -2,7 +2,7 @@
title: Recieving Mail thru MXRoute
description: Trusted receiver
published: true
date: 2026-02-25T17:18:07.245Z
date: 2026-02-25T17:18:16.273Z
tags:
editor: markdown
dateCreated: 2026-02-15T01:44:15.683Z

View file

@ -2,7 +2,7 @@
title: Setting Up Kopia
description:
published: true
date: 2026-02-13T17:10:40.442Z
date: 2026-02-20T04:27:59.823Z
tags:
editor: markdown
dateCreated: 2026-01-23T22:14:17.009Z

View file

@ -2,7 +2,7 @@
title: Netgrimoire Storage
description: Where is it at
published: true
date: 2026-02-23T18:38:18.651Z
date: 2026-02-23T18:38:27.621Z
tags:
editor: markdown
dateCreated: 2026-01-22T21:10:37.035Z

View file

@ -2,7 +2,7 @@
title: ZFS Common Commands
description: ZFS Commands
published: true
date: 2026-02-18T12:38:32.940Z
date: 2026-02-20T04:26:23.798Z
tags: zfs commands
editor: markdown
dateCreated: 2026-01-31T15:23:07.585Z

View file

@ -2,7 +2,7 @@
title: ZFS-NFS-Exports
description: Exporting NFS shares from ZFS datasets
published: true
date: 2026-02-23T21:58:11.949Z
date: 2026-02-23T21:58:20.626Z
tags:
editor: markdown
dateCreated: 2026-02-01T20:45:40.210Z

View file

@ -2,7 +2,7 @@
title: Netgrimoire Service Catalog
description: Done or soon to be
published: true
date: 2026-03-29T16:05:26.168Z
date: 2026-03-29T16:05:32.761Z
tags:
editor: markdown
dateCreated: 2026-03-29T16:05:26.168Z