From 4b7eca8a463c80640220541b056845d4c92f5b4d Mon Sep 17 00:00:00 2001 From: Cal Corum Date: Thu, 12 Mar 2026 09:00:44 -0500 Subject: [PATCH] docs: add YAML frontmatter to all 151 markdown files Adds title, description, type, domain, and tags frontmatter to every doc for improved KB semantic search. The description field is prepended to every search chunk, and domain/type/tags enable filtered queries. Type values: context, guide, runbook, reference, troubleshooting Domain values match directory structure (networking, docker, etc.) Co-Authored-By: Claude Opus 4.6 --- SKILLS_AUDIT_2026-03-05.md | 8 ++++++++ backups/CONTEXT.md | 8 ++++++++ baldurs-gate-3-coop-friend-setup.md | 8 ++++++++ databases/CONTEXT.md | 8 ++++++++ databases/troubleshooting.md | 8 ++++++++ development/bash-CONTEXT.md | 8 ++++++++ development/bash-troubleshooting.md | 8 ++++++++ development/claude-code-memory-autoload.md | 8 ++++++++ development/debugging.md | 8 ++++++++ development/kb-rag-system.md | 8 ++++++++ development/nodejs-CONTEXT.md | 8 ++++++++ development/python-CONTEXT.md | 8 ++++++++ development/service-management.md | 8 ++++++++ development/tui-testing.md | 8 ++++++++ development/vuejs-CONTEXT.md | 8 ++++++++ development/web-frameworks.md | 8 ++++++++ docker/CONTEXT.md | 8 ++++++++ docker/examples/crash-analysis-summary.md | 8 ++++++++ docker/examples/distributed-transcoding.md | 8 ++++++++ .../docker-iptables-troubleshooting-session.md | 8 ++++++++ docker/examples/gpu-acceleration.md | 8 ++++++++ docker/examples/multi-stage-builds.md | 8 ++++++++ docker/examples/nvidia-gpu-troubleshooting.md | 8 ++++++++ docker/examples/nvidia-troubleshooting.md | 8 ++++++++ docker/examples/tdarr-container-fixes.md | 8 ++++++++ docker/examples/tdarr-monitoring-configuration.md | 8 ++++++++ docker/examples/tdarr-node-configurations.md | 8 ++++++++ docker/examples/tdarr-server-setup/README.md | 8 ++++++++ docker/examples/tdarr-troubleshooting.md | 8 ++++++++ docker/examples/troubleshooting.md | 8 ++++++++ docker/scripts/CONTEXT.md | 8 ++++++++ docker/troubleshooting.md | 8 ++++++++ gaming/CONTEXT.md | 8 ++++++++ gaming/palworld/server.md | 8 ++++++++ gaming/palworld/stl-config.md | 8 ++++++++ gaming/ready-or-not/examples/README.md | 8 ++++++++ .../ready-or-not/examples/working-baseline-config.md | 8 ++++++++ gaming/scripts/CONTEXT.md | 8 ++++++++ gaming/space-scum-demo/README.md | 8 ++++++++ gaming/stackmon/README.md | 8 ++++++++ gaming/troubleshooting.md | 8 ++++++++ media-servers/CONTEXT.md | 8 ++++++++ media-servers/jellyfin-ubuntu-manticore.md | 8 ++++++++ media-servers/troubleshooting.md | 8 ++++++++ media-tools/CONTEXT.md | 8 ++++++++ media-tools/scripts/CONTEXT.md | 8 ++++++++ media-tools/troubleshooting.md | 8 ++++++++ monitoring/CONTEXT.md | 8 ++++++++ monitoring/examples/cron-job-management.md | 8 ++++++++ .../recovered-lxc300/server-diagnostics/SKILL.md | 11 +++++------ monitoring/scripts/CONTEXT.md | 8 ++++++++ monitoring/scripts/README.md | 8 ++++++++ monitoring/scripts/setup-discord-monitoring.md | 8 ++++++++ monitoring/scripts/windows-desktop/README.md | 8 ++++++++ .../windows-desktop/windows-setup-instructions.md | 8 ++++++++ monitoring/server-diagnostics/CONTEXT.md | 8 ++++++++ monitoring/troubleshooting.md | 8 ++++++++ networking/CONTEXT.md | 8 ++++++++ networking/examples/cifs-mount-resilience-fixes.md | 8 ++++++++ networking/examples/nas-mount-configuration.md | 8 ++++++++ .../examples/network-filesystem-limitations.md | 8 ++++++++ networking/examples/nginx-config.md | 8 ++++++++ networking/examples/security_improvements.md | 8 ++++++++ networking/examples/ssh-homelab-setup.md | 8 ++++++++ networking/examples/ssh-key-management.md | 8 ++++++++ networking/examples/ssh-troubleshooting.md | 8 ++++++++ networking/examples/troubleshooting.md | 8 ++++++++ networking/npm-configuration.md | 8 ++++++++ networking/pihole-disk-optimization.md | 8 ++++++++ networking/pihole-ha-deployment-notes.md | 8 ++++++++ networking/pihole-ha-setup.md | 8 ++++++++ networking/scripts/CONTEXT.md | 8 ++++++++ networking/server-inventory.md | 8 ++++++++ networking/troubleshooting.md | 8 ++++++++ ollama-benchmark-results.md | 8 ++++++++ ollama-benchmarks.md | 8 ++++++++ ollama-model-testing.md | 8 ++++++++ productivity/CONTEXT.md | 8 ++++++++ productivity/google-workspace-cli.md | 8 ++++++++ productivity/handy-speech-to-text.md | 8 ++++++++ productivity/n8n/CONTEXT.md | 8 ++++++++ productivity/n8n/README.md | 8 ++++++++ productivity/n8n/troubleshooting.md | 8 ++++++++ productivity/n8n/workflows/QUICK-START.md | 8 ++++++++ productivity/n8n/workflows/README.md | 8 ++++++++ .../n8n/workflows/claude-agent-notifications.md | 8 ++++++++ .../n8n/workflows/kofi-implementation-notes.md | 8 ++++++++ productivity/n8n/workflows/kofi-paper-dynasty.md | 8 ++++++++ productivity/n8n/workflows/kofi-testing-guide.md | 8 ++++++++ productivity/openclaw/CONTEXT.md | 8 ++++++++ productivity/openclaw/DEPLOYMENT_STATUS.md | 8 ++++++++ productivity/openclaw/README.md | 8 ++++++++ productivity/openclaw/troubleshooting.md | 8 ++++++++ productivity/troubleshooting.md | 8 ++++++++ scheduled-tasks/CONTEXT.md | 8 ++++++++ server-configs/README.md | 8 ++++++++ server-configs/caddy-migration/MIGRATION.md | 8 ++++++++ server-configs/caddy-migration/README.md | 8 ++++++++ server-configs/gitea/INDEX.md | 8 ++++++++ server-configs/gitea/README.md | 8 ++++++++ server-configs/gitea/deployment-strategies.md | 8 ++++++++ server-configs/gitea/harbor-registry-setup.md | 8 ++++++++ server-configs/gitea/workflow-templates/README.md | 8 ++++++++ .../n8n/docker-compose/omni-tools/README.md | 8 ++++++++ .../networking/nginx-proxy-manager-pihole.md | 8 ++++++++ server-configs/termix/README.md | 8 ++++++++ tabletop/age-of-ashes/gm-reference.md | 8 ++++++++ tcg/README.md | 8 ++++++++ tcg/card-design-notes.md | 8 ++++++++ tcg/project-sol-rulebook/CONVERSION-REPORT.md | 8 ++++++++ tcg/project-sol-rulebook/README.md | 8 ++++++++ .../afflictions-and-conditions.md | 8 ++++++++ tcg/project-sol-rulebook/attributes-and-skills.md | 8 ++++++++ tcg/project-sol-rulebook/character-creation.md | 8 ++++++++ tcg/project-sol-rulebook/character-qualities.md | 8 ++++++++ tcg/project-sol-rulebook/drones.md | 8 ++++++++ tcg/project-sol-rulebook/equipment.md | 8 ++++++++ tcg/project-sol-rulebook/hacking.md | 8 ++++++++ tcg/project-sol-rulebook/how-to-play.md | 8 ++++++++ tcg/project-sol-rulebook/physical-combat.md | 8 ++++++++ tcg/project-sol-rulebook/social-combat.md | 8 ++++++++ tcg/project-sol-rulebook/spacecraft-combat.md | 8 ++++++++ tcg/project-sol-rulebook/structures.md | 8 ++++++++ tcg/project-sol-rulebook/wealth.md | 8 ++++++++ tdarr/CONTEXT.md | 8 ++++++++ tdarr/archive/README.md | 10 +++++++++- .../tdarr-cifs-troubleshooting-2025-08-11.md | 8 ++++++++ tdarr/examples/tdarr-node-configurations.md | 8 ++++++++ tdarr/examples/tdarr-server-setup/README.md | 8 ++++++++ tdarr/scripts/CONTEXT.md | 8 ++++++++ tdarr/scripts/README.md | 8 ++++++++ tdarr/troubleshooting.md | 8 ++++++++ tdarr/ubuntu-manticore-setup.md | 8 ++++++++ vm-management/CONTEXT.md | 8 ++++++++ vm-management/examples/proxmox-automation.md | 8 ++++++++ vm-management/examples/troubleshooting.md | 8 ++++++++ vm-management/lxc-migration-plan.md | 8 ++++++++ vm-management/migration-quick-start.md | 8 ++++++++ .../proxmox-upgrades/proxmox-7-to-9-upgrade-plan.md | 8 ++++++++ vm-management/scripts/CONTEXT.md | 8 ++++++++ vm-management/scripts/LXC-MIGRATION-GUIDE.md | 8 ++++++++ vm-management/scripts/README.md | 8 ++++++++ vm-management/troubleshooting.md | 8 ++++++++ vm-management/wave1-migration-results.md | 8 ++++++++ vm-management/wave2-migration-results.md | 8 ++++++++ workstation/CONTEXT.md | 8 ++++++++ workstation/claude-code-config.md | 12 ++++++++++-- 147 files changed, 1176 insertions(+), 9 deletions(-) diff --git a/SKILLS_AUDIT_2026-03-05.md b/SKILLS_AUDIT_2026-03-05.md index 5024b14..65e0b18 100644 --- a/SKILLS_AUDIT_2026-03-05.md +++ b/SKILLS_AUDIT_2026-03-05.md @@ -1,3 +1,11 @@ +--- +title: "Claude Code Skills Audit" +description: "Audit of 17 custom skills, 5 commands, and marketplace plugins against native Claude Code capabilities, with retire/keep/optimize decisions and migration notes." +type: reference +domain: development +tags: [claude-code, skills, audit, commands, mcp, optimization] +--- + # Skills Audit Report - 2026-03-05 ## Overview diff --git a/backups/CONTEXT.md b/backups/CONTEXT.md index fdcc8a2..8de6aa6 100644 --- a/backups/CONTEXT.md +++ b/backups/CONTEXT.md @@ -1,3 +1,11 @@ +--- +title: "Backups Overview" +description: "Restic backup system for nobara-desktop with systemd timers, backing up /home to TrueNAS NAS. Covers configuration, retention policy, Discord failure alerts, and troubleshooting stale locks." +type: context +domain: backups +tags: [restic, backup, systemd, truenas, discord, retention, nobara-desktop] +--- + # Backups - Technology Context ## Overview diff --git a/baldurs-gate-3-coop-friend-setup.md b/baldurs-gate-3-coop-friend-setup.md index ccf95ce..c61acb1 100644 --- a/baldurs-gate-3-coop-friend-setup.md +++ b/baldurs-gate-3-coop-friend-setup.md @@ -1,3 +1,11 @@ +--- +title: "BG3 Coop Modded Setup on Linux" +description: "Step-by-step guide for a friend to join a modded Baldur's Gate 3 coop game on Linux, covering GE-Proton, BG3 Mod Manager, Script Extender, mod import, and SteamTinkerLaunch config." +type: guide +domain: gaming +tags: [baldurs-gate-3, coop, linux, proton, modding, steam, steamtinkerlaunch] +--- + # BG3 Coop Friend Setup (Linux) Quick setup guide for joining a modded BG3 coop game. Uses pre-packaged mod archive for identical setup. diff --git a/databases/CONTEXT.md b/databases/CONTEXT.md index 1782687..30c453b 100644 --- a/databases/CONTEXT.md +++ b/databases/CONTEXT.md @@ -1,3 +1,11 @@ +--- +title: "Database Patterns Overview" +description: "Directory overview for database topics including design patterns, performance optimization, backup strategies, and security/access control for MySQL, PostgreSQL, and Redis." +type: context +domain: databases +tags: [database, mysql, postgresql, redis, performance, backup, security] +--- + # Database Patterns ## Database Design diff --git a/databases/troubleshooting.md b/databases/troubleshooting.md index dd5734f..9612a4d 100644 --- a/databases/troubleshooting.md +++ b/databases/troubleshooting.md @@ -1,3 +1,11 @@ +--- +title: "Database Troubleshooting" +description: "Troubleshooting guide for MySQL, PostgreSQL, and Redis covering connection failures, slow queries, data corruption, backup issues, replication problems, and emergency recovery procedures." +type: troubleshooting +domain: databases +tags: [database, mysql, postgresql, redis, troubleshooting, recovery, replication] +--- + # Database Troubleshooting Guide ## Connection Issues diff --git a/development/bash-CONTEXT.md b/development/bash-CONTEXT.md index 0e0b46a..02a60db 100644 --- a/development/bash-CONTEXT.md +++ b/development/bash-CONTEXT.md @@ -1,3 +1,11 @@ +--- +title: "Bash Scripting Patterns" +description: "Bash scripting conventions for script structure, error handling, argument parsing, and security. Covers systemd integration, backup scripts, deployment automation, and monitoring." +type: context +domain: development +tags: [bash, scripting, systemd, automation, shell] +--- + # Bash Scripting Patterns ## Script Structure diff --git a/development/bash-troubleshooting.md b/development/bash-troubleshooting.md index 407b0ff..963c279 100644 --- a/development/bash-troubleshooting.md +++ b/development/bash-troubleshooting.md @@ -1,3 +1,11 @@ +--- +title: "Bash Script Troubleshooting" +description: "Troubleshooting guide for bash scripts covering debug modes (set -x), error traps, variable/parameter validation, file permission checks, process management, string comparison, and system resource monitoring." +type: troubleshooting +domain: development +tags: [bash, troubleshooting, debugging, scripting, error-handling, shell] +--- + # Bash Script Troubleshooting Reference ## Script Debugging diff --git a/development/claude-code-memory-autoload.md b/development/claude-code-memory-autoload.md index b70e92e..7e6a9f0 100644 --- a/development/claude-code-memory-autoload.md +++ b/development/claude-code-memory-autoload.md @@ -1,3 +1,11 @@ +--- +title: "Claude Code Memory Auto-Load" +description: "How MEMORY.md symlinks to cognitive memory CORE.md provide automatic context injection into every Claude Code session. Covers the symlink mechanism, daily refresh via systemd, and manual refresh commands." +type: guide +domain: development +tags: [claude-code, cognitive-memory, symlinks, systemd, automation] +--- + # Claude Code Memory Auto-Load (CORE.md Symlinks) ## Problem diff --git a/development/debugging.md b/development/debugging.md index e5a0509..6a23bd3 100644 --- a/development/debugging.md +++ b/development/debugging.md @@ -1,3 +1,11 @@ +--- +title: "Python Debugging Reference" +description: "Python debugging techniques including pdb/breakpoint usage, logging setup, memory profiling with tracemalloc, cProfile performance profiling, and SQLAlchemy query debugging." +type: reference +domain: development +tags: [python, debugging, pdb, logging, profiling, sqlalchemy, memory] +--- + # Python Debugging Reference ## Common Error Patterns diff --git a/development/kb-rag-system.md b/development/kb-rag-system.md index 50218fa..6f6827a 100644 --- a/development/kb-rag-system.md +++ b/development/kb-rag-system.md @@ -1,3 +1,11 @@ +--- +title: "Knowledge Base RAG System" +description: "Semantic search system (md-kb-rag) over claude-home docs using vector embeddings. Covers Docker stack architecture on manticore, Qdrant + nomic-embed pipeline, MCP integration, Gitea webhook auto-sync, and troubleshooting." +type: guide +domain: development +tags: [kb-rag, mcp, qdrant, embeddings, docker, gitea, semantic-search, manticore] +--- + # Knowledge Base RAG System (md-kb-rag) ## Overview diff --git a/development/nodejs-CONTEXT.md b/development/nodejs-CONTEXT.md index 05b6410..41ec392 100644 --- a/development/nodejs-CONTEXT.md +++ b/development/nodejs-CONTEXT.md @@ -1,3 +1,11 @@ +--- +title: "Node.js Development Patterns" +description: "Node.js coding patterns and conventions for Express.js APIs, middleware, event-driven architecture, and microservices. Covers error handling, security, and dependency management." +type: context +domain: development +tags: [nodejs, javascript, express, patterns, microservices, security] +--- + # Node.js Patterns ## Project Setup diff --git a/development/python-CONTEXT.md b/development/python-CONTEXT.md index be66dfb..1e862ae 100644 --- a/development/python-CONTEXT.md +++ b/development/python-CONTEXT.md @@ -1,3 +1,11 @@ +--- +title: "Python Development Patterns" +description: "Python coding patterns and conventions for project structure, code organization, error handling, and performance. Covers venv, async/await, factory pattern, and context managers." +type: context +domain: development +tags: [python, patterns, async, error-handling, performance] +--- + # Python Patterns ## Project Structure diff --git a/development/service-management.md b/development/service-management.md index c04107f..13177dc 100644 --- a/development/service-management.md +++ b/development/service-management.md @@ -1,3 +1,11 @@ +--- +title: "Bash Service Management Examples" +description: "Bash script examples for systemd service installation, lifecycle management (start/stop/restart/status/logs), and process monitoring with PID-based health checks and auto-restart." +type: reference +domain: development +tags: [bash, systemd, service-management, process-monitoring, scripting] +--- + # Bash Service Management Examples ## Systemd Service Script diff --git a/development/tui-testing.md b/development/tui-testing.md index 6f55e88..322074d 100644 --- a/development/tui-testing.md +++ b/development/tui-testing.md @@ -1,3 +1,11 @@ +--- +title: "TUI Testing with mcp-tui-driver" +description: "Guide to using mcp-tui-driver for Playwright-like TUI automation in Claude Code. Covers installation, MCP config, all 23 tools (session, keyboard, mouse, scripting), testing workflows, and accessibility snapshots." +type: guide +domain: development +tags: [tui, testing, mcp, automation, mcp-tui-driver, claude-code] +--- + # TUI Testing with mcp-tui-driver ## Overview diff --git a/development/vuejs-CONTEXT.md b/development/vuejs-CONTEXT.md index 697d097..fa13bb0 100644 --- a/development/vuejs-CONTEXT.md +++ b/development/vuejs-CONTEXT.md @@ -1,3 +1,11 @@ +--- +title: "Vue.js Development Patterns" +description: "Vue.js component architecture, state management with Pinia, Composition API patterns, and performance optimization. Covers TypeScript integration, Vite builds, and testing with Vitest." +type: context +domain: development +tags: [vuejs, javascript, pinia, composition-api, vite, typescript] +--- + # Vue.js Patterns ## Component Architecture diff --git a/development/web-frameworks.md b/development/web-frameworks.md index 7a8df36..881cfb5 100644 --- a/development/web-frameworks.md +++ b/development/web-frameworks.md @@ -1,3 +1,11 @@ +--- +title: "Python Web Framework Examples" +description: "Code examples for Flask and FastAPI web applications including API structure, async patterns, SQLAlchemy integration, and configuration management with dataclasses." +type: reference +domain: development +tags: [python, flask, fastapi, sqlalchemy, web-api, async] +--- + # Python Web Framework Examples ## Flask API Structure diff --git a/docker/CONTEXT.md b/docker/CONTEXT.md index 3c44222..3398390 100644 --- a/docker/CONTEXT.md +++ b/docker/CONTEXT.md @@ -1,3 +1,11 @@ +--- +title: "Docker Container Technology Context" +description: "Architecture patterns, GPU acceleration, performance optimization, and security practices for Docker/Podman containerization in homelab environments." +type: context +domain: docker +tags: [docker, podman, containers, gpu, nvidia, architecture, security, compose] +--- + # Docker Container Technology - Technology Context ## Overview diff --git a/docker/examples/crash-analysis-summary.md b/docker/examples/crash-analysis-summary.md index a112d2c..096cb55 100644 --- a/docker/examples/crash-analysis-summary.md +++ b/docker/examples/crash-analysis-summary.md @@ -1,3 +1,11 @@ +--- +title: "System Crash Analysis - CIFS/Tdarr" +description: "Root cause analysis of a kernel-level deadlock caused by CIFS network mount failures during intensive Tdarr transcoding, resulting in memory corruption, RCU stalls, and a hard system crash on Nobara." +type: troubleshooting +domain: docker +tags: [crash-analysis, kernel, cifs, tdarr, memory-corruption, rcu-stall, nobara, transcoding] +--- + # KDE Plasma Crash Analysis Summary **Date**: 2025-08-11 diff --git a/docker/examples/distributed-transcoding.md b/docker/examples/distributed-transcoding.md index 1a1e74b..3e8e56d 100644 --- a/docker/examples/distributed-transcoding.md +++ b/docker/examples/distributed-transcoding.md @@ -1,3 +1,11 @@ +--- +title: "Tdarr Distributed Transcoding" +description: "Architecture and configuration for Tdarr distributed transcoding with unmapped nodes, NVMe cache optimization, hybrid storage strategy, gaming-aware scheduling, and horizontal scaling patterns." +type: guide +domain: docker +tags: [tdarr, distributed, transcoding, podman, gpu, nvme, cache, gaming-scheduler, monitoring] +--- + # Tdarr Distributed Transcoding Pattern ## Overview diff --git a/docker/examples/docker-iptables-troubleshooting-session.md b/docker/examples/docker-iptables-troubleshooting-session.md index 3b8e541..d89309b 100644 --- a/docker/examples/docker-iptables-troubleshooting-session.md +++ b/docker/examples/docker-iptables-troubleshooting-session.md @@ -1,3 +1,11 @@ +--- +title: "Docker iptables/nftables Troubleshooting" +description: "Detailed troubleshooting session for Docker daemon failing to start due to iptables/nftables backend conflicts on Nobara (Fedora-based), including NAT chain creation errors and legacy backend workarounds." +type: troubleshooting +domain: docker +tags: [docker, iptables, nftables, fedora, nobara, networking, nat, firewall] +--- + # Docker iptables/nftables Backend Troubleshooting Session ## Session Context diff --git a/docker/examples/gpu-acceleration.md b/docker/examples/gpu-acceleration.md index e4ae81f..c16973e 100644 --- a/docker/examples/gpu-acceleration.md +++ b/docker/examples/gpu-acceleration.md @@ -1,3 +1,11 @@ +--- +title: "GPU Acceleration in Containers" +description: "Patterns for enabling NVIDIA GPU acceleration in Docker and Podman containers, including CDI, runtime, and Compose methods, plus the critical Fedora/Nobara Docker Desktop GPU failure and Podman workaround." +type: reference +domain: docker +tags: [gpu, nvidia, docker, podman, cuda, nvenc, fedora, tdarr, cdi] +--- + # GPU Acceleration in Docker Containers ## Overview diff --git a/docker/examples/multi-stage-builds.md b/docker/examples/multi-stage-builds.md index f55a3ee..02d4fb4 100644 --- a/docker/examples/multi-stage-builds.md +++ b/docker/examples/multi-stage-builds.md @@ -1,3 +1,11 @@ +--- +title: "Multi-Stage Docker Builds" +description: "Reference examples for multi-stage Docker builds in Node.js and Python, showing how to minimize image size and separate build from runtime dependencies." +type: reference +domain: docker +tags: [docker, dockerfile, multi-stage, nodejs, python, optimization] +--- + # Multi-Stage Docker Builds ## Basic Multi-Stage Pattern diff --git a/docker/examples/nvidia-gpu-troubleshooting.md b/docker/examples/nvidia-gpu-troubleshooting.md index b8fbcb8..860d58c 100644 --- a/docker/examples/nvidia-gpu-troubleshooting.md +++ b/docker/examples/nvidia-gpu-troubleshooting.md @@ -1,3 +1,11 @@ +--- +title: "NVIDIA GPU Container Troubleshooting" +description: "Troubleshooting guide for NVIDIA GPU access in containers on Fedora/Nobara, explaining why Docker Desktop fails and Podman works, with verification commands and complete setup steps." +type: troubleshooting +domain: docker +tags: [nvidia, gpu, podman, docker, fedora, nobara, cuda, container-toolkit, troubleshooting] +--- + # NVIDIA GPU Container Troubleshooting Guide ## Key Insights from Fedora/Nobara GPU Container Issues diff --git a/docker/examples/nvidia-troubleshooting.md b/docker/examples/nvidia-troubleshooting.md index 79a72e0..ab571b7 100644 --- a/docker/examples/nvidia-troubleshooting.md +++ b/docker/examples/nvidia-troubleshooting.md @@ -1,3 +1,11 @@ +--- +title: "NVIDIA Container Toolkit Setup" +description: "Installation and troubleshooting reference for nvidia-container-toolkit on Fedora/DNF and Ubuntu/APT, covering daemon.json configuration, CDI method, and GPU detection issues." +type: reference +domain: docker +tags: [nvidia, container-toolkit, gpu, docker, fedora, ubuntu, installation, daemon-json] +--- + # NVIDIA Container Toolkit Troubleshooting ## Installation by Distribution diff --git a/docker/examples/tdarr-container-fixes.md b/docker/examples/tdarr-container-fixes.md index 5de40fd..7b7a189 100644 --- a/docker/examples/tdarr-container-fixes.md +++ b/docker/examples/tdarr-container-fixes.md @@ -1,3 +1,11 @@ +--- +title: "Tdarr Container Memory Fixes" +description: "Container configuration changes to prevent kernel memory corruption caused by CIFS streaming during Tdarr transcoding, including unmapped node conversion, resource limits, and I/O constraints." +type: runbook +domain: docker +tags: [tdarr, memory-corruption, cifs, container-limits, unmapped-node, podman, resource-management] +--- + # Tdarr Container Memory Corruption Fixes **Date**: 2025-08-11 diff --git a/docker/examples/tdarr-monitoring-configuration.md b/docker/examples/tdarr-monitoring-configuration.md index c276812..4b3599b 100644 --- a/docker/examples/tdarr-monitoring-configuration.md +++ b/docker/examples/tdarr-monitoring-configuration.md @@ -1,3 +1,11 @@ +--- +title: "Tdarr Monitoring Configuration" +description: "Active Discord monitoring system for Tdarr worker timeouts, staging stalls, and operational status, covering log-based polling, API-based health checks, and automated cleanup with Discord webhook alerts." +type: reference +domain: docker +tags: [tdarr, monitoring, discord, webhook, cron, systemd, api, alerting, automation] +--- + # Tdarr Monitoring Configuration - Discord Integration ## Overview diff --git a/docker/examples/tdarr-node-configurations.md b/docker/examples/tdarr-node-configurations.md index c5d94b1..768ea4b 100644 --- a/docker/examples/tdarr-node-configurations.md +++ b/docker/examples/tdarr-node-configurations.md @@ -1,3 +1,11 @@ +--- +title: "Tdarr Node Container Configurations" +description: "Complete container configurations for Tdarr transcoding nodes including CPU-only Docker Compose, GPU-accelerated Podman, and GPU Docker setups with platform-specific recommendations." +type: reference +domain: docker +tags: [tdarr, docker, podman, gpu, nvidia, transcoding, compose, containers] +--- + # Tdarr Node Container Configurations ## Overview diff --git a/docker/examples/tdarr-server-setup/README.md b/docker/examples/tdarr-server-setup/README.md index d7f4a4d..98fce1f 100644 --- a/docker/examples/tdarr-server-setup/README.md +++ b/docker/examples/tdarr-server-setup/README.md @@ -1,3 +1,11 @@ +--- +title: "Tdarr Server Setup" +description: "Tdarr server container setup guide covering directory structure, hybrid local/network storage strategy, major version upgrade process, and common operational issues." +type: guide +domain: docker +tags: [tdarr, docker, compose, storage, upgrade, server] +--- + # Tdarr Server Setup Example ## Directory Structure diff --git a/docker/examples/tdarr-troubleshooting.md b/docker/examples/tdarr-troubleshooting.md index ea07396..0e6950b 100644 --- a/docker/examples/tdarr-troubleshooting.md +++ b/docker/examples/tdarr-troubleshooting.md @@ -1,3 +1,11 @@ +--- +title: "Tdarr forEach Error Troubleshooting" +description: "Complete troubleshooting history for Tdarr forEach plugin errors, from root cause (stale Stonefish plugin mounts) through resolution (clean install with unmapped node architecture), including staging timeout monitoring system." +type: troubleshooting +domain: docker +tags: [tdarr, plugins, foreach-error, stonefish, unmapped-node, monitoring, transcoding, troubleshooting] +--- + # Tdarr forEach Error Troubleshooting Summary ## Problem Statement diff --git a/docker/examples/troubleshooting.md b/docker/examples/troubleshooting.md index 4d10c57..37f4a17 100644 --- a/docker/examples/troubleshooting.md +++ b/docker/examples/troubleshooting.md @@ -1,3 +1,11 @@ +--- +title: "Docker Quick Troubleshooting Reference" +description: "Concise quick-reference for common Docker troubleshooting commands covering container startup, build failures, performance monitoring, network debugging, and system cleanup." +type: troubleshooting +domain: docker +tags: [docker, troubleshooting, quick-reference, networking, builds, cleanup] +--- + # Docker Troubleshooting Reference ## Container Won't Start diff --git a/docker/scripts/CONTEXT.md b/docker/scripts/CONTEXT.md index 4caac31..0405d1a 100644 --- a/docker/scripts/CONTEXT.md +++ b/docker/scripts/CONTEXT.md @@ -1,3 +1,11 @@ +--- +title: "Docker Scripts Context" +description: "Operational context for Docker container management scripts directory, covering planned automation categories and development guidelines for future scripts." +type: context +domain: docker +tags: [docker, scripts, automation, orchestration, monitoring] +--- + # Docker Scripts - Operational Context ## Script Overview diff --git a/docker/troubleshooting.md b/docker/troubleshooting.md index 4349f3d..0d23cf8 100644 --- a/docker/troubleshooting.md +++ b/docker/troubleshooting.md @@ -1,3 +1,11 @@ +--- +title: "Docker Container Troubleshooting" +description: "Troubleshooting guide for Docker and Podman containers covering startup failures, GPU issues, build errors, networking, performance, and emergency recovery procedures." +type: troubleshooting +domain: docker +tags: [docker, podman, troubleshooting, gpu, nvidia, networking, performance, fedora] +--- + # Docker Container Troubleshooting Guide ## Container Startup Issues diff --git a/gaming/CONTEXT.md b/gaming/CONTEXT.md index b60eb66..cfd6ee4 100644 --- a/gaming/CONTEXT.md +++ b/gaming/CONTEXT.md @@ -1,3 +1,11 @@ +--- +title: "Gaming Configuration Overview" +description: "Directory overview for Linux gaming setup with Steam Tinker Launch (STL), Proton, and NVIDIA RTX 4080 SUPER. Covers standard config baselines, per-game docs, DRM-free archives, and hardware specs." +type: context +domain: gaming +tags: [steam, proton, stl, nvidia, gamescope, mangohud, linux-gaming] +--- + # Gaming Configuration Context ## Technology Overview diff --git a/gaming/palworld/server.md b/gaming/palworld/server.md index 7dc90b0..092506e 100644 --- a/gaming/palworld/server.md +++ b/gaming/palworld/server.md @@ -1,3 +1,11 @@ +--- +title: "Palworld Dedicated Server" +description: "Setup and management of the Palworld dedicated server running in Proxmox LXC 230. Covers SteamCMD installation, systemd service, REST API, credentials, and backup configuration." +type: runbook +domain: gaming +tags: [palworld, dedicated-server, proxmox, lxc, steamcmd, systemd] +--- + # Palworld - Dedicated Server | Field | Value | diff --git a/gaming/palworld/stl-config.md b/gaming/palworld/stl-config.md index 9d16d5b..ffe2141 100644 --- a/gaming/palworld/stl-config.md +++ b/gaming/palworld/stl-config.md @@ -1,3 +1,11 @@ +--- +title: "Palworld STL Configuration" +description: "Steam Tinker Launch configuration for Palworld (App ID 1623730) on Linux. Covers DLSS setup, DX11/DX12 modes, GE-Proton compatibility, and Unreal Engine 5 tweaks." +type: reference +domain: gaming +tags: [palworld, stl, proton, dlss, nvidia, unreal-engine, dxvk] +--- + # Palworld - STL Configuration | Field | Value | diff --git a/gaming/ready-or-not/examples/README.md b/gaming/ready-or-not/examples/README.md index 99414bd..abe2d26 100644 --- a/gaming/ready-or-not/examples/README.md +++ b/gaming/ready-or-not/examples/README.md @@ -1,3 +1,11 @@ +--- +title: "Ready or Not NVIDIA Setup" +description: "Optimized Steam Tinker Launch configuration for Ready or Not (App ID 1144200) on NVIDIA GPUs. Includes GameScope scaling, DLSS setup, 1440p config, and setup scripts adapted from AMD baseline." +type: guide +domain: gaming +tags: [ready-or-not, nvidia, stl, dlss, gamescope, proton, dx12] +--- + # Ready or Not - NVIDIA Gaming Setup ## Overview diff --git a/gaming/ready-or-not/examples/working-baseline-config.md b/gaming/ready-or-not/examples/working-baseline-config.md index 767f22e..512eb74 100644 --- a/gaming/ready-or-not/examples/working-baseline-config.md +++ b/gaming/ready-or-not/examples/working-baseline-config.md @@ -1,3 +1,11 @@ +--- +title: "Ready or Not Working Baseline" +description: "Confirmed working baseline configuration for Ready or Not on Proton 9.25. Documents test results, DX11 test strategy, and incremental STL configuration plan for NVIDIA RTX 4080 SUPER." +type: reference +domain: gaming +tags: [ready-or-not, proton, stl, baseline, nvidia, dlss, dx11] +--- + # Ready or Not - Working Baseline Configuration ## ✅ Confirmed Working Setup diff --git a/gaming/scripts/CONTEXT.md b/gaming/scripts/CONTEXT.md index 0fdb1a9..bc69b34 100644 --- a/gaming/scripts/CONTEXT.md +++ b/gaming/scripts/CONTEXT.md @@ -1,3 +1,11 @@ +--- +title: "Gaming Scripts Reference" +description: "Documentation for gaming automation scripts including STL config reset, mod installation, direct launch, log analysis, crash diagnosis, and compatibility testing for Ready or Not and other titles." +type: context +domain: gaming +tags: [scripts, bash, stl, ready-or-not, proton, diagnostics, automation] +--- + # Gaming Scripts Context ## Overview diff --git a/gaming/space-scum-demo/README.md b/gaming/space-scum-demo/README.md index f6680c9..003dbad 100644 --- a/gaming/space-scum-demo/README.md +++ b/gaming/space-scum-demo/README.md @@ -1,3 +1,11 @@ +--- +title: "Space Scum Demo Archive" +description: "Game profile for Space Scum Demo (App ID 3777540), a roguelike card-based dungeon crawler. Demo ended and archived to TrueNAS for offline play. No special STL configuration needed." +type: reference +domain: gaming +tags: [space-scum, archive, drm-free, gamemaker, proton] +--- + # Space Scum Demo | Field | Value | diff --git a/gaming/stackmon/README.md b/gaming/stackmon/README.md index 8f14287..e675c90 100644 --- a/gaming/stackmon/README.md +++ b/gaming/stackmon/README.md @@ -1,3 +1,11 @@ +--- +title: "Stackmon Playtest Archive" +description: "Game profile for Stackmon (App ID 3729550), a creature-collector card-stacking game. Playtest ended and archived to TrueNAS for offline play. Uses standard DX11 STL config." +type: reference +domain: gaming +tags: [stackmon, archive, drm-free, proton, stl] +--- + # Stackmon | Field | Value | diff --git a/gaming/troubleshooting.md b/gaming/troubleshooting.md index c9a0911..930aad4 100644 --- a/gaming/troubleshooting.md +++ b/gaming/troubleshooting.md @@ -1,3 +1,11 @@ +--- +title: "Gaming Troubleshooting Guide" +description: "Troubleshooting solutions for Linux gaming issues including launch failures, performance problems, audio/display issues, NVIDIA GPU detection, DLSS, ray tracing, and Ready or Not-specific fixes." +type: troubleshooting +domain: gaming +tags: [steam, proton, stl, nvidia, dlss, gamescope, ready-or-not, dxvk, audio, pipewire] +--- + # Gaming Troubleshooting Guide ## Quick Fixes by Issue Type diff --git a/media-servers/CONTEXT.md b/media-servers/CONTEXT.md index de0c492..024da63 100644 --- a/media-servers/CONTEXT.md +++ b/media-servers/CONTEXT.md @@ -1,3 +1,11 @@ +--- +title: "Media Servers Overview" +description: "Technology context for Jellyfin and Plex media server infrastructure including GPU-accelerated transcoding, storage strategy, multi-service GPU sharing, and client discovery." +type: context +domain: media-servers +tags: [jellyfin, plex, nvidia, nvenc, gpu, transcoding, docker, streaming] +--- + # Media Servers - Technology Context ## Overview diff --git a/media-servers/jellyfin-ubuntu-manticore.md b/media-servers/jellyfin-ubuntu-manticore.md index aff57d9..2c4418f 100644 --- a/media-servers/jellyfin-ubuntu-manticore.md +++ b/media-servers/jellyfin-ubuntu-manticore.md @@ -1,3 +1,11 @@ +--- +title: "Jellyfin Setup on ubuntu-manticore" +description: "Complete Jellyfin deployment guide on ubuntu-manticore (10.10.0.226) with Docker Compose, NVIDIA GTX 1070 GPU transcoding, storage layout, driver management, and GPU health monitoring." +type: guide +domain: media-servers +tags: [jellyfin, docker, nvidia, gpu, ubuntu-manticore, nvenc, driver-management, monitoring] +--- + # Jellyfin Setup on ubuntu-manticore ## Overview diff --git a/media-servers/troubleshooting.md b/media-servers/troubleshooting.md index f080d85..bb89425 100644 --- a/media-servers/troubleshooting.md +++ b/media-servers/troubleshooting.md @@ -1,3 +1,11 @@ +--- +title: "Media Servers Troubleshooting" +description: "Troubleshooting guide for Jellyfin media server issues including GPU transcoding failures, driver mismatches, container startup problems, network connectivity, Roku/Apple TV playback, and emergency recovery." +type: troubleshooting +domain: media-servers +tags: [jellyfin, nvidia, gpu, transcoding, docker, roku, troubleshooting, recovery] +--- + # Media Servers - Troubleshooting Guide ## Common Issues and Solutions diff --git a/media-tools/CONTEXT.md b/media-tools/CONTEXT.md index a7c2cc9..6c7dc02 100644 --- a/media-tools/CONTEXT.md +++ b/media-tools/CONTEXT.md @@ -1,3 +1,11 @@ +--- +title: "Media Tools Overview" +description: "Directory overview for media downloading tools using Playwright browser automation and yt-dlp, covering architecture patterns, anti-bot handling, and state management." +type: context +domain: media-tools +tags: [yt-dlp, playwright, web-scraping, video-download, browser-automation] +--- + # Media Tools Tools for downloading and managing media from streaming sites. diff --git a/media-tools/scripts/CONTEXT.md b/media-tools/scripts/CONTEXT.md index 2e962ad..4fabe1d 100644 --- a/media-tools/scripts/CONTEXT.md +++ b/media-tools/scripts/CONTEXT.md @@ -1,3 +1,11 @@ +--- +title: "Media Tools Scripts Reference" +description: "Usage reference for media download scripts including pokeflix_scraper.py CLI options, output structure, state file format, and guide for adding new scrapers." +type: reference +domain: media-tools +tags: [pokeflix, scraper, yt-dlp, playwright, cli, scripts] +--- + # Media Tools Scripts Operational scripts for media downloading and management. diff --git a/media-tools/troubleshooting.md b/media-tools/troubleshooting.md index 21883db..ef9e64e 100644 --- a/media-tools/troubleshooting.md +++ b/media-tools/troubleshooting.md @@ -1,3 +1,11 @@ +--- +title: "Media Tools Troubleshooting" +description: "Solutions for Playwright browser automation failures, yt-dlp download errors, scraping issues, and resume/state file problems in media download tools." +type: troubleshooting +domain: media-tools +tags: [yt-dlp, playwright, scraping, debugging, video-download] +--- + # Media Tools Troubleshooting ## Common Issues diff --git a/monitoring/CONTEXT.md b/monitoring/CONTEXT.md index 5b195ae..661605a 100644 --- a/monitoring/CONTEXT.md +++ b/monitoring/CONTEXT.md @@ -1,3 +1,11 @@ +--- +title: "Monitoring and Alerting Overview" +description: "Architecture overview of the homelab monitoring system including Uptime Kuma, Claude Runner (CT 302) two-tier health checks, Tdarr monitoring, Windows desktop monitoring, and n8n master/sub-workflow orchestration." +type: context +domain: monitoring +tags: [uptime-kuma, claude-runner, n8n, discord, healthcheck, tdarr, windows, infrastructure] +--- + # System Monitoring and Alerting - Technology Context ## Overview diff --git a/monitoring/examples/cron-job-management.md b/monitoring/examples/cron-job-management.md index df56f14..f57316f 100644 --- a/monitoring/examples/cron-job-management.md +++ b/monitoring/examples/cron-job-management.md @@ -1,3 +1,11 @@ +--- +title: "Cron Job Management Patterns" +description: "Cron job patterns for homelab monitoring including current schedules, HERE document best practices, resource-aware scheduling, security considerations, and debugging techniques for cron environment issues." +type: reference +domain: monitoring +tags: [cron, scheduling, tdarr, bash, automation, maintenance] +--- + # Cron Job Management Patterns This document outlines the cron job patterns and management strategies used in the home lab environment. diff --git a/monitoring/recovered-lxc300/server-diagnostics/SKILL.md b/monitoring/recovered-lxc300/server-diagnostics/SKILL.md index 29c53a5..90d3ad1 100644 --- a/monitoring/recovered-lxc300/server-diagnostics/SKILL.md +++ b/monitoring/recovered-lxc300/server-diagnostics/SKILL.md @@ -1,10 +1,9 @@ --- -name: server-diagnostics -description: | - Automated server troubleshooting for Docker containers and system health. - Provides SSH-based diagnostics, log reading, metrics collection, and low-risk - remediation. USE WHEN N8N triggers troubleshooting, container issues detected, - or system health checks needed. +title: "Server Diagnostics Skill" +description: "Recovered LXC 300 skill reference for automated server troubleshooting. Covers Docker container diagnostics, SSH-based health checks, log reading, metrics collection, remediation workflows, and security constraints." +type: runbook +domain: monitoring +tags: [server-diagnostics, docker, ssh, health-check, remediation, n8n, paper-dynasty] --- # Server Diagnostics - Automated Troubleshooting diff --git a/monitoring/scripts/CONTEXT.md b/monitoring/scripts/CONTEXT.md index b838f75..2990a3f 100644 --- a/monitoring/scripts/CONTEXT.md +++ b/monitoring/scripts/CONTEXT.md @@ -1,3 +1,11 @@ +--- +title: "Monitoring Scripts Context" +description: "Operational context for all monitoring scripts: Jellyfin GPU health monitor, NVIDIA driver update checker, Tdarr API/file monitors, and Windows reboot detection. Includes cron schedules, Discord integration patterns, and troubleshooting." +type: context +domain: monitoring +tags: [jellyfin, gpu, nvidia, tdarr, discord, cron, python, windows, scripts] +--- + # Monitoring Scripts - Operational Context ## Script Overview diff --git a/monitoring/scripts/README.md b/monitoring/scripts/README.md index 3295ebc..9ffec43 100644 --- a/monitoring/scripts/README.md +++ b/monitoring/scripts/README.md @@ -1,3 +1,11 @@ +--- +title: "Monitoring Scripts Reference" +description: "Reference for available monitoring scripts including tdarr_monitor.py usage and check types, tdarr-timeout-monitor.sh, Windows desktop monitoring, and Discord integration setup." +type: reference +domain: monitoring +tags: [tdarr, discord, windows, scripts, python, powershell] +--- + # Monitoring Scripts This directory contains various monitoring scripts and tools for the home lab infrastructure. diff --git a/monitoring/scripts/setup-discord-monitoring.md b/monitoring/scripts/setup-discord-monitoring.md index 9d1fd09..0a75597 100644 --- a/monitoring/scripts/setup-discord-monitoring.md +++ b/monitoring/scripts/setup-discord-monitoring.md @@ -1,3 +1,11 @@ +--- +title: "Discord Monitoring Setup Guide" +description: "Step-by-step setup guide for Tdarr Discord webhook notifications including webhook creation, cron/systemd scheduling, alert customization, and troubleshooting webhook delivery." +type: guide +domain: monitoring +tags: [discord, webhook, tdarr, cron, systemd, alerts, setup] +--- + # Tdarr Discord Monitoring Setup Guide ## Overview diff --git a/monitoring/scripts/windows-desktop/README.md b/monitoring/scripts/windows-desktop/README.md index c212b1d..c34cfbf 100644 --- a/monitoring/scripts/windows-desktop/README.md +++ b/monitoring/scripts/windows-desktop/README.md @@ -1,3 +1,11 @@ +--- +title: "Windows Desktop Monitoring System" +description: "Overview of Windows reboot and system event monitoring with Discord notifications. Covers PowerShell scripts, Task Scheduler integration, event log analysis, and notification types for startup/shutdown/crash detection." +type: reference +domain: monitoring +tags: [windows, powershell, discord, reboot, event-log, task-scheduler] +--- + # Windows Desktop Monitoring System A comprehensive solution for monitoring Windows machine reboots and system events with Discord notifications. diff --git a/monitoring/scripts/windows-desktop/windows-setup-instructions.md b/monitoring/scripts/windows-desktop/windows-setup-instructions.md index 277cb33..47c5b49 100644 --- a/monitoring/scripts/windows-desktop/windows-setup-instructions.md +++ b/monitoring/scripts/windows-desktop/windows-setup-instructions.md @@ -1,3 +1,11 @@ +--- +title: "Windows Reboot Monitor Setup" +description: "Installation and configuration guide for Windows reboot/shutdown Discord notifications using PowerShell scripts and Task Scheduler, including webhook setup, testing, and uninstallation." +type: guide +domain: monitoring +tags: [windows, powershell, discord, webhook, task-scheduler, reboot, setup] +--- + # Windows Reboot Monitor Setup Instructions This guide will help you set up Discord notifications for Windows reboots due to updates, power outages, or other events. diff --git a/monitoring/server-diagnostics/CONTEXT.md b/monitoring/server-diagnostics/CONTEXT.md index 37507fb..f74318d 100644 --- a/monitoring/server-diagnostics/CONTEXT.md +++ b/monitoring/server-diagnostics/CONTEXT.md @@ -1,3 +1,11 @@ +--- +title: "Server Diagnostics Architecture" +description: "Deployment and architecture docs for the CT 302 claude-runner two-tier health monitoring system. Covers n8n integration, cost model, repository layout, SSH auth, and adding new servers to monitoring." +type: reference +domain: monitoring +tags: [claude-runner, server-diagnostics, n8n, ssh, health-check, ct-302, gitea] +--- + # Server Diagnostics — Deployment & Architecture ## Overview diff --git a/monitoring/troubleshooting.md b/monitoring/troubleshooting.md index c29ac29..b328ff1 100644 --- a/monitoring/troubleshooting.md +++ b/monitoring/troubleshooting.md @@ -1,3 +1,11 @@ +--- +title: "Monitoring Troubleshooting Guide" +description: "Troubleshooting procedures for Discord webhook failures, Tdarr monitoring issues, Windows PowerShell script problems, log rotation, cron job failures, network false positives, and monitoring overhead." +type: troubleshooting +domain: monitoring +tags: [discord, webhook, tdarr, windows, powershell, cron, log-rotation, network, alerts] +--- + # Monitoring System Troubleshooting Guide ## Discord Notification Issues diff --git a/networking/CONTEXT.md b/networking/CONTEXT.md index c348574..0895f66 100644 --- a/networking/CONTEXT.md +++ b/networking/CONTEXT.md @@ -1,3 +1,11 @@ +--- +title: "Networking Infrastructure Context" +description: "Architecture patterns and best practices for homelab networking including reverse proxy, SSH key management, DNS, SSL/TLS, network segmentation, and CIFS mounts." +type: context +domain: networking +tags: [nginx, ssh, dns, ssl, vlan, cifs, reverse-proxy, firewall] +--- + # Networking Infrastructure - Technology Context ## Overview diff --git a/networking/examples/cifs-mount-resilience-fixes.md b/networking/examples/cifs-mount-resilience-fixes.md index 003f2a2..bd176dc 100644 --- a/networking/examples/cifs-mount-resilience-fixes.md +++ b/networking/examples/cifs-mount-resilience-fixes.md @@ -1,3 +1,11 @@ +--- +title: "CIFS Mount Resilience Fixes" +description: "Improved CIFS fstab config to prevent kernel deadlocks during NAS network issues, with soft mounts, interrupt handling, reduced buffers, and systemd automount." +type: runbook +domain: networking +tags: [cifs, smb, nas, fstab, kernel, stability, truenas] +--- + # CIFS Mount Resilience Improvements **Date**: 2025-08-11 diff --git a/networking/examples/nas-mount-configuration.md b/networking/examples/nas-mount-configuration.md index 853e4a3..7662e7d 100644 --- a/networking/examples/nas-mount-configuration.md +++ b/networking/examples/nas-mount-configuration.md @@ -1,3 +1,11 @@ +--- +title: "NAS SMB Mount Optimization" +description: "Optimized TrueNAS SMB 3.1.1 mount configs achieving 103 MB/s on tdarr-server and 85 MB/s on workstation, with buffer tuning, cache strategy, and stability notes." +type: reference +domain: networking +tags: [cifs, smb, truenas, nas, performance, fstab, tdarr] +--- + # NAS Mount Configuration - TrueNAS SMB Optimization ## Overview diff --git a/networking/examples/network-filesystem-limitations.md b/networking/examples/network-filesystem-limitations.md index 36695d9..b41d049 100644 --- a/networking/examples/network-filesystem-limitations.md +++ b/networking/examples/network-filesystem-limitations.md @@ -1,3 +1,11 @@ +--- +title: "Network Filesystem Limitations" +description: "SQLite WAL locking failures on NFS/CIFS/sshfs, hybrid storage patterns for databases vs media, and mount optimization for network filesystems." +type: reference +domain: networking +tags: [nfs, cifs, sqlite, filesystem, storage, performance] +--- + # Network Filesystem Limitations ## SQLite on Network Filesystems diff --git a/networking/examples/nginx-config.md b/networking/examples/nginx-config.md index c143163..ad848bc 100644 --- a/networking/examples/nginx-config.md +++ b/networking/examples/nginx-config.md @@ -1,3 +1,11 @@ +--- +title: "Nginx Configuration Examples" +description: "Reference nginx configs for reverse proxy with SSL, load balancing with health checks, and rate limiting with connection throttling." +type: reference +domain: networking +tags: [nginx, ssl, reverse-proxy, load-balancing, rate-limiting] +--- + # Nginx Configuration Examples ## Reverse Proxy with SSL diff --git a/networking/examples/security_improvements.md b/networking/examples/security_improvements.md index 9dbe5a0..38c895b 100644 --- a/networking/examples/security_improvements.md +++ b/networking/examples/security_improvements.md @@ -1,3 +1,11 @@ +--- +title: "Home Lab Security Improvements" +description: "Security audit and migration plan from password-based SSH to key-based authentication, covering risk assessment, server hardening, and phased rollout." +type: guide +domain: networking +tags: [ssh, security, authentication, hardening, migration] +--- + # Home Lab Security Improvements ## Current Security Issues diff --git a/networking/examples/ssh-homelab-setup.md b/networking/examples/ssh-homelab-setup.md index aec4f37..2ce723e 100644 --- a/networking/examples/ssh-homelab-setup.md +++ b/networking/examples/ssh-homelab-setup.md @@ -1,3 +1,11 @@ +--- +title: "SSH Homelab Setup Implementation" +description: "Complete working SSH key-based auth setup with key generation scripts, SSH config, deployment commands, emergency keys, NAS backup, and mobile device access via Termius." +type: guide +domain: networking +tags: [ssh, keys, setup, deployment, backup, termius, mobile] +--- + # SSH Home Lab Setup - Complete Implementation ## Overview diff --git a/networking/examples/ssh-key-management.md b/networking/examples/ssh-key-management.md index 77b397b..90275a8 100644 --- a/networking/examples/ssh-key-management.md +++ b/networking/examples/ssh-key-management.md @@ -1,3 +1,11 @@ +--- +title: "SSH Key Management Patterns" +description: "Best practices for SSH key management in homelab environments including dual-key strategy, lifecycle management, network segmentation, backup, and recovery procedures." +type: guide +domain: networking +tags: [ssh, keys, security, backup, recovery, best-practices] +--- + # SSH Key Management for Home Labs ## Overview diff --git a/networking/examples/ssh-troubleshooting.md b/networking/examples/ssh-troubleshooting.md index ba1f1a1..6211811 100644 --- a/networking/examples/ssh-troubleshooting.md +++ b/networking/examples/ssh-troubleshooting.md @@ -1,3 +1,11 @@ +--- +title: "SSH Troubleshooting Reference" +description: "Solutions for common SSH issues including UseKeychain errors, key deployment failures, permission denied, port conflicts, emergency access, and key rotation." +type: troubleshooting +domain: networking +tags: [ssh, troubleshooting, keys, authentication, emergency-access] +--- + # SSH Troubleshooting Reference ## Common Configuration Issues diff --git a/networking/examples/troubleshooting.md b/networking/examples/troubleshooting.md index 457725d..259e70d 100644 --- a/networking/examples/troubleshooting.md +++ b/networking/examples/troubleshooting.md @@ -1,3 +1,11 @@ +--- +title: "Network Troubleshooting Commands" +description: "Quick-reference diagnostic commands for connectivity, port debugging, firewall rules, SSL certificates, DNS resolution, and bandwidth testing." +type: reference +domain: networking +tags: [troubleshooting, diagnostics, commands, firewall, ssl, dns, bandwidth] +--- + # Network Troubleshooting Reference ## Connectivity Issues diff --git a/networking/npm-configuration.md b/networking/npm-configuration.md index d54e5e9..bdc4ab0 100644 --- a/networking/npm-configuration.md +++ b/networking/npm-configuration.md @@ -1,3 +1,11 @@ +--- +title: "Nginx Proxy Manager Configuration" +description: "Complete NPM reverse proxy configuration for manticorum.com services including proxy hosts, SSL certificates, advanced routing, CORS, and operational procedures." +type: reference +domain: networking +tags: [nginx-proxy-manager, npm, ssl, letsencrypt, reverse-proxy, manticorum] +--- + # Nginx Proxy Manager Configuration Documentation ## Overview diff --git a/networking/pihole-disk-optimization.md b/networking/pihole-disk-optimization.md index 12692f6..b3f0499 100644 --- a/networking/pihole-disk-optimization.md +++ b/networking/pihole-disk-optimization.md @@ -1,3 +1,11 @@ +--- +title: "Pi-hole Disk Optimization" +description: "Resolved critical disk space issue on primary Pi-hole by reducing query log retention to 7 days, pruning Docker resources, and removing old gravity backups." +type: runbook +domain: networking +tags: [pihole, disk-space, docker, optimization, maintenance] +--- + # Pi-hole Disk Optimization - 2026-02-06 ## Problem diff --git a/networking/pihole-ha-deployment-notes.md b/networking/pihole-ha-deployment-notes.md index 89ea926..0a79374 100644 --- a/networking/pihole-ha-deployment-notes.md +++ b/networking/pihole-ha-deployment-notes.md @@ -1,3 +1,11 @@ +--- +title: "Pi-hole HA Deployment Notes" +description: "Deployment log for dual Pi-hole HA setup including v5-to-v6 upgrade issues, Orbital Sync auth failures, known issues, and blocklist restoration steps." +type: runbook +domain: networking +tags: [pihole, dns, high-availability, deployment, pihole-v6, orbital-sync] +--- + # Pi-hole HA Deployment Notes - 2026-02-06 ## Deployment Summary diff --git a/networking/pihole-ha-setup.md b/networking/pihole-ha-setup.md index ad84bf9..8ea4c84 100644 --- a/networking/pihole-ha-setup.md +++ b/networking/pihole-ha-setup.md @@ -1,3 +1,11 @@ +--- +title: "Pi-hole High Availability Setup" +description: "Dual Pi-hole HA architecture with Orbital Sync and NPM DNS sync, covering deployment, failover behavior, UniFi DHCP config, and testing procedures." +type: guide +domain: networking +tags: [pihole, dns, high-availability, orbital-sync, unifi, docker] +--- + # Pi-hole High Availability Setup ## Architecture Overview diff --git a/networking/scripts/CONTEXT.md b/networking/scripts/CONTEXT.md index fd24c24..4de0624 100644 --- a/networking/scripts/CONTEXT.md +++ b/networking/scripts/CONTEXT.md @@ -1,3 +1,11 @@ +--- +title: "Networking Scripts Context" +description: "Operational context for networking scripts including SSH key maintenance, backup strategy, key rotation workflows, and cron scheduling." +type: context +domain: networking +tags: [ssh, scripts, backup, key-rotation, cron, maintenance] +--- + # Networking Scripts - Operational Context ## Script Overview diff --git a/networking/server-inventory.md b/networking/server-inventory.md index 666ef9a..24710e9 100644 --- a/networking/server-inventory.md +++ b/networking/server-inventory.md @@ -1,3 +1,11 @@ +--- +title: "Server Inventory" +description: "Inventory of homelab servers and LXC containers including IPs, services, ports, storage mounts, and SSH access details for ubuntu-manticore, arr-stack, and notediscovery." +type: reference +domain: networking +tags: [inventory, servers, lxc, proxmox, docker, ubuntu-manticore, arr-stack] +--- + # Server Inventory ## Physical Servers diff --git a/networking/troubleshooting.md b/networking/troubleshooting.md index 579be0c..f74b131 100644 --- a/networking/troubleshooting.md +++ b/networking/troubleshooting.md @@ -1,3 +1,11 @@ +--- +title: "Networking Troubleshooting Guide" +description: "Comprehensive troubleshooting for SSH, DNS, reverse proxy, SSL, CIFS/NFS mounts, Pi-hole HA, iOS DNS bypass, UniFi firewall rules, and emergency recovery procedures." +type: troubleshooting +domain: networking +tags: [ssh, dns, pihole, ssl, cifs, nfs, firewall, unifi, ios, nginx, troubleshooting] +--- + # Networking Infrastructure Troubleshooting Guide ## SSH Connection Issues diff --git a/ollama-benchmark-results.md b/ollama-benchmark-results.md index 1357785..f31c72f 100644 --- a/ollama-benchmark-results.md +++ b/ollama-benchmark-results.md @@ -1,3 +1,11 @@ +--- +title: "Ollama Benchmark Results" +description: "Scoring tables for local and cloud LLM models tested via Ollama across code generation, code analysis, reasoning, data analysis, and planning categories." +type: reference +domain: development +tags: [ollama, llm, benchmarks, model-evaluation, deepseek, llama, glm] +--- + # Ollama Model Benchmark Results ## Summary Table diff --git a/ollama-benchmarks.md b/ollama-benchmarks.md index efbb6ca..6648b57 100644 --- a/ollama-benchmarks.md +++ b/ollama-benchmarks.md @@ -1,3 +1,11 @@ +--- +title: "Ollama Benchmark Prompts" +description: "Standardized prompt suite and scoring criteria for evaluating Ollama LLM models across code generation, code analysis, reasoning, data analysis, and planning tasks." +type: reference +domain: development +tags: [ollama, llm, benchmarks, prompts, model-evaluation] +--- + # Ollama Model Benchmark Prompts Use these consistent prompts to evaluate different models across similar tasks. diff --git a/ollama-model-testing.md b/ollama-model-testing.md index 6915487..05d8eb3 100644 --- a/ollama-model-testing.md +++ b/ollama-model-testing.md @@ -1,3 +1,11 @@ +--- +title: "Ollama Model Testing Log" +description: "Testing log tracking Ollama model evaluations with performance observations, VRAM requirements, and suitability ratings for different use cases on a 16GB GPU workstation." +type: reference +domain: development +tags: [ollama, llm, model-testing, vram, gpu, deepseek, glm] +--- + # Ollama Model Testing Log Track models tested, performance observations, and suitability for different use cases. diff --git a/productivity/CONTEXT.md b/productivity/CONTEXT.md index a428bd1..34f4a23 100644 --- a/productivity/CONTEXT.md +++ b/productivity/CONTEXT.md @@ -1,3 +1,11 @@ +--- +title: "Productivity Tools Context" +description: "Overview of ADHD-optimized productivity tools including task manager, Google Workspace CLI, and Handy speech-to-text. Covers architecture patterns, CLI commands, and brain dump workflows." +type: context +domain: productivity +tags: [task-manager, adhd, brain-dump, google-workspace, handy, speech-to-text, cli] +--- + # Productivity Tools - Technology Context ## Overview diff --git a/productivity/google-workspace-cli.md b/productivity/google-workspace-cli.md index d5c997b..87ec147 100644 --- a/productivity/google-workspace-cli.md +++ b/productivity/google-workspace-cli.md @@ -1,3 +1,11 @@ +--- +title: "Google Workspace CLI Reference" +description: "Reference for gws, a unified CLI for Google Drive, Gmail, Calendar, and Sheets APIs. Covers authentication, command structure, common operations, Sheets range escaping, and key spreadsheet IDs." +type: reference +domain: productivity +tags: [gws, google-workspace, drive, gmail, calendar, sheets, oauth, cli] +--- + # Google Workspace CLI (gws) ## Overview diff --git a/productivity/handy-speech-to-text.md b/productivity/handy-speech-to-text.md index 89c05f5..bf5b9fb 100644 --- a/productivity/handy-speech-to-text.md +++ b/productivity/handy-speech-to-text.md @@ -1,3 +1,11 @@ +--- +title: "Handy Speech-to-Text Setup" +description: "Installation and usage guide for Handy, a desktop speech-to-text app with system tray integration. Covers RPM install on Nobara/Fedora, CLI flags, and Wayland/GTK dependencies." +type: guide +domain: productivity +tags: [handy, speech-to-text, wayland, gtk, nobara, fedora, rpm] +--- + # Handy - Speech to Text ## Overview diff --git a/productivity/n8n/CONTEXT.md b/productivity/n8n/CONTEXT.md index db09885..b288167 100644 --- a/productivity/n8n/CONTEXT.md +++ b/productivity/n8n/CONTEXT.md @@ -1,3 +1,11 @@ +--- +title: "n8n Platform Context" +description: "Complete technical documentation for the self-hosted n8n workflow automation platform on LXC 210. Covers architecture, Docker deployment, PostgreSQL backend, Nginx Proxy Manager config, active workflows (Ko-fi, Claude agent notifications), and operational procedures." +type: context +domain: productivity +tags: [n8n, automation, workflow, docker, postgresql, webhook, lxc, nginx-proxy-manager] +--- + # n8n Workflow Automation Platform Self-hosted workflow automation platform for building integrations and automating tasks across your homelab infrastructure. diff --git a/productivity/n8n/README.md b/productivity/n8n/README.md index 79adf7b..96fb6b9 100644 --- a/productivity/n8n/README.md +++ b/productivity/n8n/README.md @@ -1,3 +1,11 @@ +--- +title: "n8n Quick Reference" +description: "Quick reference for the n8n instance at n8n.manticorum.com with SSH commands, common tasks (webhook setup, backups, updates), architecture overview, and maintenance schedule." +type: reference +domain: productivity +tags: [n8n, automation, quick-reference, docker, webhook] +--- + # n8n Workflow Automation - Quick Reference Self-hosted n8n instance at **https://n8n.manticorum.com/** diff --git a/productivity/n8n/troubleshooting.md b/productivity/n8n/troubleshooting.md index b7fa6c5..d4fd520 100644 --- a/productivity/n8n/troubleshooting.md +++ b/productivity/n8n/troubleshooting.md @@ -1,3 +1,11 @@ +--- +title: "n8n Troubleshooting Guide" +description: "Troubleshooting guide for n8n at n8n.manticorum.com covering container startup failures, PostgreSQL issues, SSL/access problems, webhook debugging, credential decryption errors, performance tuning, and emergency recovery procedures." +type: troubleshooting +domain: productivity +tags: [n8n, troubleshooting, docker, postgresql, webhook, ssl, nginx-proxy-manager] +--- + # n8n Troubleshooting Guide Common issues and solutions for the n8n deployment at n8n.manticorum.com. diff --git a/productivity/n8n/workflows/QUICK-START.md b/productivity/n8n/workflows/QUICK-START.md index 33e27c7..85b0ddd 100644 --- a/productivity/n8n/workflows/QUICK-START.md +++ b/productivity/n8n/workflows/QUICK-START.md @@ -1,3 +1,11 @@ +--- +title: "Ko-fi Integration Quick Start" +description: "30-minute setup guide for the Ko-fi to Paper Dynasty n8n integration. Step-by-step instructions for credentials, product mapping, workflow import, webhook configuration, and go-live checklist." +type: guide +domain: productivity +tags: [n8n, ko-fi, paper-dynasty, quick-start, webhook, setup] +--- + # Ko-fi → Paper Dynasty Quick Start Guide Get the Ko-fi integration running in 30 minutes. diff --git a/productivity/n8n/workflows/README.md b/productivity/n8n/workflows/README.md index 1c78b91..5d5193f 100644 --- a/productivity/n8n/workflows/README.md +++ b/productivity/n8n/workflows/README.md @@ -1,3 +1,11 @@ +--- +title: "n8n Workflows Index" +description: "Index of production n8n workflows including Ko-fi to Paper Dynasty pack distribution and Claude agent Discord notifications. Covers documentation structure, prerequisites, monitoring schedule, and security considerations." +type: context +domain: productivity +tags: [n8n, workflows, ko-fi, paper-dynasty, claude-agent, discord, index] +--- + # n8n Workflows Documentation Collection of production n8n workflows and integration guides. diff --git a/productivity/n8n/workflows/claude-agent-notifications.md b/productivity/n8n/workflows/claude-agent-notifications.md index b9775df..a86dc26 100644 --- a/productivity/n8n/workflows/claude-agent-notifications.md +++ b/productivity/n8n/workflows/claude-agent-notifications.md @@ -1,3 +1,11 @@ +--- +title: "Claude Agent Discord Notifications" +description: "Setup guide for the n8n workflow that sends Discord notifications when Claude Code subagents finish. Covers SubagentStop hook config, n8n webhook setup, Discord variable storage, payload reference, and testing." +type: guide +domain: productivity +tags: [n8n, claude-code, discord, webhook, subagent, notifications, automation] +--- + # Claude Agent Done → Discord Notifications Notifies a Discord channel via webhook when a Claude Code subagent finishes. Useful for long-running pipelines (10+ minutes) where you want a heads-up when work completes. diff --git a/productivity/n8n/workflows/kofi-implementation-notes.md b/productivity/n8n/workflows/kofi-implementation-notes.md index 501e1cf..ef02d78 100644 --- a/productivity/n8n/workflows/kofi-implementation-notes.md +++ b/productivity/n8n/workflows/kofi-implementation-notes.md @@ -1,3 +1,11 @@ +--- +title: "Ko-fi Implementation Notes" +description: "Real-world implementation notes for the Ko-fi to Paper Dynasty n8n workflow documenting deviations from the original plan, n8n community edition limitations, hardcoded product mappings, working architecture, testing results, and known limitations." +type: reference +domain: productivity +tags: [n8n, ko-fi, paper-dynasty, implementation, gotchas, lessons-learned] +--- + # Ko-fi → Paper Dynasty Implementation Notes **Date:** 2025-11-13 diff --git a/productivity/n8n/workflows/kofi-paper-dynasty.md b/productivity/n8n/workflows/kofi-paper-dynasty.md index caac20b..11c5b3f 100644 --- a/productivity/n8n/workflows/kofi-paper-dynasty.md +++ b/productivity/n8n/workflows/kofi-paper-dynasty.md @@ -1,3 +1,11 @@ +--- +title: "Ko-fi Paper Dynasty Workflow" +description: "Complete setup guide for the n8n workflow that processes Ko-fi shop orders and grants Paper Dynasty packs. Covers webhook config, multi-method team identification, product mapping, API integration, Discord notifications, and node-by-node workflow configuration." +type: guide +domain: productivity +tags: [n8n, ko-fi, paper-dynasty, webhook, discord, automation, e-commerce] +--- + # Ko-fi → Paper Dynasty Integration Automated workflow that processes Ko-fi shop orders and grants Paper Dynasty packs to users. diff --git a/productivity/n8n/workflows/kofi-testing-guide.md b/productivity/n8n/workflows/kofi-testing-guide.md index ffac6d2..7b048fe 100644 --- a/productivity/n8n/workflows/kofi-testing-guide.md +++ b/productivity/n8n/workflows/kofi-testing-guide.md @@ -1,3 +1,11 @@ +--- +title: "Ko-fi Integration Testing Guide" +description: "Testing procedures for the Ko-fi to Paper Dynasty n8n workflow with 8 cURL test scenarios, validation scripts, checklists for security/performance/edge cases, and production monitoring guidelines." +type: runbook +domain: productivity +tags: [n8n, ko-fi, paper-dynasty, testing, webhook, curl, validation] +--- + # Ko-fi → Paper Dynasty Testing Guide Comprehensive testing guide for the Ko-fi integration workflow. diff --git a/productivity/openclaw/CONTEXT.md b/productivity/openclaw/CONTEXT.md index 0622d97..a8393e7 100644 --- a/productivity/openclaw/CONTEXT.md +++ b/productivity/openclaw/CONTEXT.md @@ -1,3 +1,11 @@ +--- +title: "OpenClaw AI Assistant Context" +description: "Technical context for OpenClaw personal AI assistant on LXC 224. Covers gateway architecture, npm installation, MiniMax M2.1 integration, Discord bot configuration, Homebrew skill dependencies, systemd service management, and security model." +type: context +domain: productivity +tags: [openclaw, ai-assistant, minimax, discord, lxc, homebrew, nodejs, systemd] +--- + # OpenClaw Personal AI Assistant - Technology Context ## Overview diff --git a/productivity/openclaw/DEPLOYMENT_STATUS.md b/productivity/openclaw/DEPLOYMENT_STATUS.md index 7252fb2..a4f1204 100644 --- a/productivity/openclaw/DEPLOYMENT_STATUS.md +++ b/productivity/openclaw/DEPLOYMENT_STATUS.md @@ -1,3 +1,11 @@ +--- +title: "OpenClaw Deployment Status" +description: "Deployment checklist and status for OpenClaw on LXC 224. Tracks infrastructure setup completion, required user actions (API keys, Discord bot setup, intents), verification steps, and file locations." +type: runbook +domain: productivity +tags: [openclaw, deployment, lxc, docker, discord, minimax, checklist] +--- + # OpenClaw Deployment Status ## Infrastructure Setup - COMPLETE diff --git a/productivity/openclaw/README.md b/productivity/openclaw/README.md index 9ce3362..6bf62f7 100644 --- a/productivity/openclaw/README.md +++ b/productivity/openclaw/README.md @@ -1,3 +1,11 @@ +--- +title: "OpenClaw Quick Reference" +description: "Quick reference for OpenClaw on LXC 224 with SSH access, Docker Compose commands, Discord pairing, health checks, resource monitoring, and links to detailed documentation." +type: reference +domain: productivity +tags: [openclaw, ai-assistant, quick-reference, docker, discord, lxc] +--- + # OpenClaw Personal AI Assistant Personal AI assistant running on LXC 224 with MiniMax M2.1 integration and Discord connectivity. diff --git a/productivity/openclaw/troubleshooting.md b/productivity/openclaw/troubleshooting.md index f40e8d1..2942fa3 100644 --- a/productivity/openclaw/troubleshooting.md +++ b/productivity/openclaw/troubleshooting.md @@ -1,3 +1,11 @@ +--- +title: "OpenClaw Troubleshooting" +description: "Troubleshooting guide for OpenClaw on LXC 224 covering gateway startup failures, Discord bot connectivity, MiniMax API errors, Homebrew/skill installation issues, performance problems, and emergency recovery procedures." +type: troubleshooting +domain: productivity +tags: [openclaw, troubleshooting, discord, minimax, docker, homebrew, skills] +--- + # OpenClaw Troubleshooting Guide ## Gateway Startup Issues diff --git a/productivity/troubleshooting.md b/productivity/troubleshooting.md index 4cb686d..a178b40 100644 --- a/productivity/troubleshooting.md +++ b/productivity/troubleshooting.md @@ -1,3 +1,11 @@ +--- +title: "Task Manager Troubleshooting" +description: "Troubleshooting guide for the ADHD task manager system covering PATH issues, dashboard display problems, task management bugs, data persistence, Python dependencies, and emergency recovery." +type: troubleshooting +domain: productivity +tags: [task-manager, adhd, dashboard, rich, python, troubleshooting] +--- + # Productivity Tools Troubleshooting Guide ## Task Manager Issues diff --git a/scheduled-tasks/CONTEXT.md b/scheduled-tasks/CONTEXT.md index e724168..ff37fc1 100644 --- a/scheduled-tasks/CONTEXT.md +++ b/scheduled-tasks/CONTEXT.md @@ -1,3 +1,11 @@ +--- +title: "Scheduled Tasks Overview" +description: "Headless Claude Code sessions triggered by systemd timers using runner.sh template framework and custom dispatcher scripts. Covers task layout, settings reference, cost safety, and monitoring." +type: context +domain: scheduled-tasks +tags: [claude-code, systemd, timers, automation, headless, runner, issue-poller, pr-reviewer, backlog-triage] +--- + # Scheduled Tasks — Headless Claude Sessions on a Timer Headless Claude Code sessions triggered by systemd timers. Runs `claude -p` with task-specific prompts, tools, and cost limits — no TTY required. diff --git a/server-configs/README.md b/server-configs/README.md index 6e95d80..2729efb 100644 --- a/server-configs/README.md +++ b/server-configs/README.md @@ -1,3 +1,11 @@ +--- +title: "Server Configs Overview" +description: "Centralized system for version-controlling, syncing, and deploying Docker Compose files and VM/LXC configurations across all homelab hosts. Includes host inventory, sync-configs.sh usage, and secrets management." +type: reference +domain: server-configs +tags: [infrastructure, docker-compose, sync, deployment, homelab] +--- + # Home Lab Server Configurations Version-controlled configuration files for the home lab infrastructure. This system provides a centralized way to track, sync, and deploy Docker Compose files and VM/LXC configurations across multiple hosts. diff --git a/server-configs/caddy-migration/MIGRATION.md b/server-configs/caddy-migration/MIGRATION.md index a56b48e..4ada742 100644 --- a/server-configs/caddy-migration/MIGRATION.md +++ b/server-configs/caddy-migration/MIGRATION.md @@ -1,3 +1,11 @@ +--- +title: "NPM to Caddy Migration Runbook" +description: "Step-by-step operational runbook for migrating from Nginx Proxy Manager to Caddy on 10.10.0.16. Four phases: prepare (test on alternate ports), cutover (<2 min downtime), validate (24-48h monitoring), and cleanup. Includes rollback plan." +type: runbook +domain: server-configs +tags: [caddy, nginx-proxy-manager, migration, reverse-proxy, dns, pihole, cloudflare] +--- + # NPM to Caddy Migration Plan Step-by-step guide to migrate from Nginx Proxy Manager to Caddy on `10.10.0.16`. diff --git a/server-configs/caddy-migration/README.md b/server-configs/caddy-migration/README.md index 1d46d50..4ebd008 100644 --- a/server-configs/caddy-migration/README.md +++ b/server-configs/caddy-migration/README.md @@ -1,3 +1,11 @@ +--- +title: "Caddy Reverse Proxy Config" +description: "Caddy configuration reference replacing Nginx Proxy Manager on 10.10.0.16. Documents all 22 proxied services (public and internal-only), DNS-01 wildcard certs via Cloudflare, feature comparison with NPM, and management commands." +type: reference +domain: server-configs +tags: [caddy, reverse-proxy, cloudflare, dns-01, wildcard-cert, docker, caddyfile] +--- + # Caddy Reverse Proxy - NPM Replacement Caddy configuration to replace Nginx Proxy Manager (NPM) on `10.10.0.16` for the manticorum.com homelab. diff --git a/server-configs/gitea/INDEX.md b/server-configs/gitea/INDEX.md index 972fbfd..30f6769 100644 --- a/server-configs/gitea/INDEX.md +++ b/server-configs/gitea/INDEX.md @@ -1,3 +1,11 @@ +--- +title: "Gitea Templates and Guides Index" +description: "Quick-reference index for all Gitea CI/CD documentation, workflow templates, deployment strategies, and Harbor registry setup. Includes directory structure, common tasks, and learning path." +type: context +domain: server-configs +tags: [gitea, ci-cd, workflow-templates, index, gitea-actions] +--- + # Gitea Configuration & Templates Index Quick reference for all Gitea-related documentation and templates. diff --git a/server-configs/gitea/README.md b/server-configs/gitea/README.md index 2bc74e6..86c521e 100644 --- a/server-configs/gitea/README.md +++ b/server-configs/gitea/README.md @@ -1,3 +1,11 @@ +--- +title: "Gitea Server Setup and Config" +description: "Complete setup and configuration reference for the self-hosted Gitea instance on LXC 225 (10.10.0.225). Covers service management, Gitea Actions CI/CD runner setup, shared composite actions, branch protection, backup/restore, and troubleshooting." +type: reference +domain: server-configs +tags: [gitea, git, ci-cd, gitea-actions, lxc, postgresql, docker-runner, branch-protection] +--- + # Gitea - Self-Hosted Git Server **LXC 225** | **10.10.0.225** | **git.manticorum.com** diff --git a/server-configs/gitea/deployment-strategies.md b/server-configs/gitea/deployment-strategies.md index 025fdda..5819b1c 100644 --- a/server-configs/gitea/deployment-strategies.md +++ b/server-configs/gitea/deployment-strategies.md @@ -1,3 +1,11 @@ +--- +title: "CI/CD Deployment Strategies" +description: "Decision framework and implementation guide for choosing deployment automation levels (manual through blue-green). Covers 5 progressive strategies with safety best practices, rollback procedures, and per-project recommendations." +type: guide +domain: server-configs +tags: [gitea, ci-cd, deployment, docker, rollback, blue-green, health-checks] +--- + # Deployment Strategies for Gitea CI/CD Guide to choosing and implementing deployment automation for your projects. diff --git a/server-configs/gitea/harbor-registry-setup.md b/server-configs/gitea/harbor-registry-setup.md index d2a6f33..a8bafce 100644 --- a/server-configs/gitea/harbor-registry-setup.md +++ b/server-configs/gitea/harbor-registry-setup.md @@ -1,3 +1,11 @@ +--- +title: "Harbor Registry Setup Guide" +description: "Step-by-step guide to deploying Harbor as a self-hosted Docker registry on a Proxmox LXC. Covers installation, NPM reverse proxy config, Gitea Actions integration, vulnerability scanning, backup strategy, and troubleshooting." +type: guide +domain: server-configs +tags: [harbor, docker-registry, proxmox, lxc, gitea-actions, vulnerability-scanning, docker] +--- + # Harbor Docker Registry Setup Guide Complete guide to setting up Harbor on a Proxmox LXC for self-hosted Docker registry. diff --git a/server-configs/gitea/workflow-templates/README.md b/server-configs/gitea/workflow-templates/README.md index e8de8aa..253c200 100644 --- a/server-configs/gitea/workflow-templates/README.md +++ b/server-configs/gitea/workflow-templates/README.md @@ -1,3 +1,11 @@ +--- +title: "Gitea Actions Workflow Templates" +description: "Reusable CI/CD workflow templates for Gitea Actions including Docker build pipelines with version validation, Docker Hub push, Discord notifications, and multi-registry support. Based on Paper Dynasty reference implementation." +type: reference +domain: server-configs +tags: [gitea, gitea-actions, ci-cd, docker, workflow, templates, discord-webhook] +--- + # Gitea Actions Workflow Templates Reusable CI/CD workflow templates for Gitea Actions (GitHub Actions compatible). diff --git a/server-configs/n8n/docker-compose/omni-tools/README.md b/server-configs/n8n/docker-compose/omni-tools/README.md index fc1bab7..bdad483 100644 --- a/server-configs/n8n/docker-compose/omni-tools/README.md +++ b/server-configs/n8n/docker-compose/omni-tools/README.md @@ -1,3 +1,11 @@ +--- +title: "OmniTools Deployment Reference" +description: "Deployment and management reference for the OmniTools self-hosted web utility suite (image/video/PDF processing) running on the n8n LXC at 10.10.0.210:8080. All processing is client-side." +type: reference +domain: server-configs +tags: [omni-tools, docker, self-hosted, utilities, n8n-lxc] +--- + # OmniTools - Self-Hosted Utility Suite **Container**: omni-tools diff --git a/server-configs/networking/nginx-proxy-manager-pihole.md b/server-configs/networking/nginx-proxy-manager-pihole.md index 20584bb..8c6a6bf 100644 --- a/server-configs/networking/nginx-proxy-manager-pihole.md +++ b/server-configs/networking/nginx-proxy-manager-pihole.md @@ -1,3 +1,11 @@ +--- +title: "NPM and Pi-hole HA DNS Setup" +description: "Configuration reference for Nginx Proxy Manager reverse proxy and dual Pi-hole high-availability DNS across npm-pihole (10.10.0.16) and ubuntu-manticore (10.10.0.226). Covers NPM-to-Pi-hole DNS sync, Orbital Sync, Cloudflare real IP config, access lists, and troubleshooting 403 errors." +type: reference +domain: server-configs +tags: [nginx-proxy-manager, pihole, dns, high-availability, reverse-proxy, cloudflare, orbital-sync] +--- + # Nginx Proxy Manager + Pi-hole Setup **Primary Host**: 10.10.0.16 (npm-pihole) diff --git a/server-configs/termix/README.md b/server-configs/termix/README.md index d44b06d..0613e26 100644 --- a/server-configs/termix/README.md +++ b/server-configs/termix/README.md @@ -1,3 +1,11 @@ +--- +title: "Termix SSH Management Platform" +description: "Setup and configuration reference for Termix, a self-hosted web-based SSH management platform on LXC 210 (10.10.0.210:8180). Covers deployment, host import, terminal/file/Docker features, RBAC/2FA security, NPM integration, backup/restore, and troubleshooting." +type: reference +domain: server-configs +tags: [termix, ssh, docker, lxc, web-terminal, server-management, security] +--- + # Termix - SSH Server Management Platform **LXC 210 (n8n)** | **10.10.0.210:8180** | **termix.manticorum.com** diff --git a/tabletop/age-of-ashes/gm-reference.md b/tabletop/age-of-ashes/gm-reference.md index 27e4330..b580b90 100644 --- a/tabletop/age-of-ashes/gm-reference.md +++ b/tabletop/age-of-ashes/gm-reference.md @@ -1,3 +1,11 @@ +--- +title: "Age of Ashes GM Reference" +description: "Comprehensive GM reference for the Age of Ashes AP (PF2e levels 1-20) — includes full campaign synopsis, Alseta's Ring gate details, villain hierarchy, Book 1 chapter-by-chapter breakdown with community fixes, errata, encounter balance advice, and VTT map resources." +type: reference +domain: tabletop +tags: [age-of-ashes, pathfinder-2e, gm-reference, alsetas-ring, hellknight-hill, foundry-vtt, errata] +--- + # Age of Ashes: GM Reference Guide ## Book 1 — Hellknight Hill (Levels 1-5) diff --git a/tcg/README.md b/tcg/README.md index 1c2cd31..105b62c 100644 --- a/tcg/README.md +++ b/tcg/README.md @@ -1,3 +1,11 @@ +--- +title: "Baseball TCG Design Document" +description: "Core design document for a 1v1 baseball trading card game with 9-inning structure, covering card types, mechanics, keywords, resource systems, and development roadmap." +type: reference +domain: tcg +tags: [baseball-tcg, game-design, card-types, mechanics, deck-construction] +--- + # Baseball Trading Card Game - Design Document ## Core Concept diff --git a/tcg/card-design-notes.md b/tcg/card-design-notes.md index a20b603..ec9214e 100644 --- a/tcg/card-design-notes.md +++ b/tcg/card-design-notes.md @@ -1,3 +1,11 @@ +--- +title: "Card Evolution Mechanic Notes" +description: "Design notes for a Pokemon-style evolution mechanic ('Up Your Game') for the baseball TCG, covering named and unnamed player evolution paths." +type: reference +domain: tcg +tags: [baseball-tcg, card-design, evolution, game-mechanics] +--- + # Card Design Notes ## Evolution Mechanic: "Up Your Game" diff --git a/tcg/project-sol-rulebook/CONVERSION-REPORT.md b/tcg/project-sol-rulebook/CONVERSION-REPORT.md index 3ffbd7c..dc4c171 100644 --- a/tcg/project-sol-rulebook/CONVERSION-REPORT.md +++ b/tcg/project-sol-rulebook/CONVERSION-REPORT.md @@ -1,3 +1,11 @@ +--- +title: "Notion Conversion Report" +description: "Technical report on the Notion-to-Markdown conversion of the Project Sol rulebook, tracking page retrieval status, database conversions, and remaining work." +type: reference +domain: tcg +tags: [project-sol, notion, migration, conversion-report] +--- + # Project Sol Rulebook - Notion to Markdown Conversion Report ## Executive Summary diff --git a/tcg/project-sol-rulebook/README.md b/tcg/project-sol-rulebook/README.md index e91dd21..ac35aac 100644 --- a/tcg/project-sol-rulebook/README.md +++ b/tcg/project-sol-rulebook/README.md @@ -1,3 +1,11 @@ +--- +title: "Project Sol Rulebook Overview" +description: "Main index and introduction for the Project Sol TTRPG system, a sci-fi dice pool RPG inspired by Shadowrun, Starfinder, and Traveller." +type: context +domain: tcg +tags: [project-sol, ttrpg, sci-fi, rulebook, dice-pool] +--- + # Project Sol - Online Rulebook Hey, guys! Thanks for checking this out. Below are my goals for the system. I think if we've ever discussed rpgs in any detail you all know I love the dice pool mechanic, but hate Shadowrun's magic system. Those feelings combined with my love of sci-fi spawned this project. What was originally my attempt at "fixing" Shadowrun 5, grew legs and turned into its own system. diff --git a/tcg/project-sol-rulebook/afflictions-and-conditions.md b/tcg/project-sol-rulebook/afflictions-and-conditions.md index 06d3a6e..a31b1ef 100644 --- a/tcg/project-sol-rulebook/afflictions-and-conditions.md +++ b/tcg/project-sol-rulebook/afflictions-and-conditions.md @@ -1,3 +1,11 @@ +--- +title: "Afflictions and Conditions" +description: "Placeholder for Project Sol status effects including afflictions, conditions, and their mechanical impacts on characters." +type: reference +domain: tcg +tags: [project-sol, conditions, afflictions, status-effects, placeholder] +--- + # Afflictions and Conditions *(This page requires full data retrieval from Notion page ID: 43610355-65ea-41c5-b875-56e13e21a6f0)* diff --git a/tcg/project-sol-rulebook/attributes-and-skills.md b/tcg/project-sol-rulebook/attributes-and-skills.md index 2d34f11..80bd2fe 100644 --- a/tcg/project-sol-rulebook/attributes-and-skills.md +++ b/tcg/project-sol-rulebook/attributes-and-skills.md @@ -1,3 +1,11 @@ +--- +title: "Attributes and Skills Reference" +description: "Definitions of all physical attributes (AGI, BOD, REA, STR), mental attributes (CHA, INT, LOG, WIL), the Edge special attribute, and the skill system for Project Sol." +type: reference +domain: tcg +tags: [project-sol, attributes, skills, character-stats] +--- + # Attributes and Skills # Attributes diff --git a/tcg/project-sol-rulebook/character-creation.md b/tcg/project-sol-rulebook/character-creation.md index 5563019..3e7649b 100644 --- a/tcg/project-sol-rulebook/character-creation.md +++ b/tcg/project-sol-rulebook/character-creation.md @@ -1,3 +1,11 @@ +--- +title: "Character Creation Lifepath" +description: "Step-by-step character creation for Project Sol using a lifepath system from Fledgling through Seventies, plus quality selection and equipment purchasing." +type: guide +domain: tcg +tags: [project-sol, character-creation, lifepath, occupations, qualities] +--- + # Character Creation When you begin, your character is a fledgling with just enough ability to walk and not regularly shit themselves. You will guide your character through as many steps of their life as you would like before running the final calculations and being ready for play. It is recommended to take your character to at least early adulthood for your GM's mental well being. diff --git a/tcg/project-sol-rulebook/character-qualities.md b/tcg/project-sol-rulebook/character-qualities.md index cef9e30..c9d3173 100644 --- a/tcg/project-sol-rulebook/character-qualities.md +++ b/tcg/project-sol-rulebook/character-qualities.md @@ -1,3 +1,11 @@ +--- +title: "Character Qualities" +description: "Overview of positive and negative character qualities selected during Project Sol character creation, with point-buy mechanics." +type: reference +domain: tcg +tags: [project-sol, character-creation, qualities, traits] +--- + # Character Qualities Qualities can only be selected by players during character creation. Positive qualites cost points and negative qualities provide bonus points to be spent on positive qualities. diff --git a/tcg/project-sol-rulebook/drones.md b/tcg/project-sol-rulebook/drones.md index 339bef4..f54de33 100644 --- a/tcg/project-sol-rulebook/drones.md +++ b/tcg/project-sol-rulebook/drones.md @@ -1,3 +1,11 @@ +--- +title: "Drone Mechanics" +description: "Placeholder for Project Sol drone rules covering drone operation, control, and combat use." +type: reference +domain: tcg +tags: [project-sol, drones, vehicles, placeholder] +--- + # Drones *(This page requires full data retrieval from Notion page ID: 7f49463f-50a9-4812-a57c-820fe78bba48)* diff --git a/tcg/project-sol-rulebook/equipment.md b/tcg/project-sol-rulebook/equipment.md index 33832ed..e84f0c6 100644 --- a/tcg/project-sol-rulebook/equipment.md +++ b/tcg/project-sol-rulebook/equipment.md @@ -1,3 +1,11 @@ +--- +title: "Equipment and Gear Rules" +description: "Equipment rules for Project Sol covering item bulk, carrying limits, buying/selling, gear durability, repair mechanics, and illegal equipment acquisition." +type: reference +domain: tcg +tags: [project-sol, equipment, bulk, gear, repair, commerce] +--- + # Equipment
diff --git a/tcg/project-sol-rulebook/hacking.md b/tcg/project-sol-rulebook/hacking.md index 9f0590f..49dd92a 100644 --- a/tcg/project-sol-rulebook/hacking.md +++ b/tcg/project-sol-rulebook/hacking.md @@ -1,3 +1,11 @@ +--- +title: "Hacking System" +description: "Placeholder for Project Sol hacking mechanics covering electronic warfare, intrusion, and cybersecurity systems." +type: guide +domain: tcg +tags: [project-sol, hacking, cybersecurity, electronic-warfare, placeholder] +--- + # Hacking *(This page requires full data retrieval from Notion page ID: 94a4bb88-b9eb-4900-862f-3231fc3bdac5)* diff --git a/tcg/project-sol-rulebook/how-to-play.md b/tcg/project-sol-rulebook/how-to-play.md index 078ed55..2472328 100644 --- a/tcg/project-sol-rulebook/how-to-play.md +++ b/tcg/project-sol-rulebook/how-to-play.md @@ -1,3 +1,11 @@ +--- +title: "How to Play Project Sol" +description: "Core mechanics for Project Sol including dice pools, skill tests, glitches, critical successes, Edge spending/burning, teamwork, and character advancement." +type: guide +domain: tcg +tags: [project-sol, dice-pool, skill-tests, edge, character-advancement, core-mechanics] +--- + # How to Play # Dice Pools diff --git a/tcg/project-sol-rulebook/physical-combat.md b/tcg/project-sol-rulebook/physical-combat.md index b910099..a290d3a 100644 --- a/tcg/project-sol-rulebook/physical-combat.md +++ b/tcg/project-sol-rulebook/physical-combat.md @@ -1,3 +1,11 @@ +--- +title: "Physical Combat Rules" +description: "Complete physical combat system for Project Sol including initiative, action points, wound levels, armor soaking, combat modifiers (cover, flanking, prone), and natural recovery." +type: guide +domain: tcg +tags: [project-sol, combat, initiative, wounds, damage, recovery] +--- + # Physical Combat Physical combat is cyclical: everyone rolls Initiative and acts from highest to lowest and then loops back to the top. Each combat round takes roughly 10 seconds. If any combatants are surprised, they start the combat with only one action point. When a character may act during a combat round, they have three action points to spend on combat actions. At the end of their turn, their points refresh. The action points may be spent as Reactions before their turn, but they lose access to the points until their points refresh at the end of their next turn. diff --git a/tcg/project-sol-rulebook/social-combat.md b/tcg/project-sol-rulebook/social-combat.md index 25bfaa5..22f8921 100644 --- a/tcg/project-sol-rulebook/social-combat.md +++ b/tcg/project-sol-rulebook/social-combat.md @@ -1,3 +1,11 @@ +--- +title: "Social Combat Rules" +description: "Placeholder for Project Sol social combat mechanics covering persuasion, intimidation, and social conflict resolution." +type: guide +domain: tcg +tags: [project-sol, social-combat, placeholder] +--- + # Social Combat *(This page requires full data retrieval from Notion page ID: 3f951086-b61b-4c91-a838-5e60f993b84e)* diff --git a/tcg/project-sol-rulebook/spacecraft-combat.md b/tcg/project-sol-rulebook/spacecraft-combat.md index 1c0322e..92e674e 100644 --- a/tcg/project-sol-rulebook/spacecraft-combat.md +++ b/tcg/project-sol-rulebook/spacecraft-combat.md @@ -1,3 +1,11 @@ +--- +title: "Spacecraft Combat Rules" +description: "Placeholder for Project Sol spacecraft combat mechanics covering ship-to-ship engagements and crew roles during space battles." +type: guide +domain: tcg +tags: [project-sol, spacecraft, space-combat, placeholder] +--- + # Spacecraft Combat *(This page requires full data retrieval from Notion page ID: 37d2ff13-b1ed-4bdf-b6d4-16995ce37e88)* diff --git a/tcg/project-sol-rulebook/structures.md b/tcg/project-sol-rulebook/structures.md index fb483f8..417f77b 100644 --- a/tcg/project-sol-rulebook/structures.md +++ b/tcg/project-sol-rulebook/structures.md @@ -1,3 +1,11 @@ +--- +title: "Structure Rules" +description: "Placeholder for Project Sol structure mechanics covering building durability, breaching, and structural damage." +type: reference +domain: tcg +tags: [project-sol, structures, environment, placeholder] +--- + # Structures *(This page requires full data retrieval from Notion page ID: ceba7fa2-9a64-4ad9-b9d0-2dc1d4ac9809)* diff --git a/tcg/project-sol-rulebook/wealth.md b/tcg/project-sol-rulebook/wealth.md index d7c5438..a47e8e1 100644 --- a/tcg/project-sol-rulebook/wealth.md +++ b/tcg/project-sol-rulebook/wealth.md @@ -1,3 +1,11 @@ +--- +title: "Wealth and Economy System" +description: "Project Sol wealth rating system covering abstract wealth levels, cost ratings, credit spending, wealth increases, and pooling credits for group purchases." +type: guide +domain: tcg +tags: [project-sol, wealth, economy, credits, purchasing] +--- + # Wealth # Wealth Rating diff --git a/tdarr/CONTEXT.md b/tdarr/CONTEXT.md index 3c83ed5..f8ad6c4 100644 --- a/tdarr/CONTEXT.md +++ b/tdarr/CONTEXT.md @@ -1,3 +1,11 @@ +--- +title: "Tdarr Transcoding System Context" +description: "Overview of the Tdarr distributed transcoding deployment on ubuntu-manticore, including Docker Compose config, storage architecture, queue status, performance metrics, and API access." +type: context +domain: tdarr +tags: [tdarr, transcoding, docker, nvidia, nvenc, gpu, hevc, ubuntu-manticore] +--- + # Tdarr Transcoding System - Technology Context ## Overview diff --git a/tdarr/archive/README.md b/tdarr/archive/README.md index 498d9ef..5cd1aab 100644 --- a/tdarr/archive/README.md +++ b/tdarr/archive/README.md @@ -1,4 +1,12 @@ -# Legacy Tdarr Scripts +--- +title: "Legacy Tdarr Scripts Archive" +description: "Archive index for deprecated Tdarr scripts: local node monitor (stuck job detection), file completion monitor, and flow backup. All archived after migration to ubuntu-manticore mapped node." +type: reference +domain: tdarr +tags: [tdarr, archive, legacy, monitoring, flow-plugin] +--- + +# Legacy Tdarr Scripts Archive ## tdarr_monitor_local_node.py diff --git a/tdarr/examples/tdarr-cifs-troubleshooting-2025-08-11.md b/tdarr/examples/tdarr-cifs-troubleshooting-2025-08-11.md index ecb9146..9c34477 100644 --- a/tdarr/examples/tdarr-cifs-troubleshooting-2025-08-11.md +++ b/tdarr/examples/tdarr-cifs-troubleshooting-2025-08-11.md @@ -1,3 +1,11 @@ +--- +title: "CIFS Mount Troubleshooting Session" +description: "Detailed investigation of Tdarr download timeouts caused by suboptimal Linux CIFS mount configuration. Covers root cause analysis (soft mounts, strict caching), Windows vs Linux SMB differences, and optimized fstab settings for large file transfers." +type: troubleshooting +domain: tdarr +tags: [tdarr, cifs, smb, fstab, truenas, network, linux, mount] +--- + # Tdarr CIFS Troubleshooting Session - 2025-08-11 ## Problem Statement diff --git a/tdarr/examples/tdarr-node-configurations.md b/tdarr/examples/tdarr-node-configurations.md index c5d94b1..c5a2c5e 100644 --- a/tdarr/examples/tdarr-node-configurations.md +++ b/tdarr/examples/tdarr-node-configurations.md @@ -1,3 +1,11 @@ +--- +title: "Tdarr Node Container Configurations" +description: "Reference examples for Tdarr node containers: CPU-only Docker Compose, GPU-accelerated Podman (mapped and unmapped), GPU Docker Compose, environment variables, volume mounts, and platform-specific recommendations." +type: reference +domain: tdarr +tags: [tdarr, docker, podman, nvidia, gpu, nvenc, container, configuration] +--- + # Tdarr Node Container Configurations ## Overview diff --git a/tdarr/examples/tdarr-server-setup/README.md b/tdarr/examples/tdarr-server-setup/README.md index d7f4a4d..96e7add 100644 --- a/tdarr/examples/tdarr-server-setup/README.md +++ b/tdarr/examples/tdarr-server-setup/README.md @@ -1,3 +1,11 @@ +--- +title: "Tdarr Server Setup Example" +description: "Reference for Tdarr server directory structure, storage strategy (local vs network), major version upgrade process, and common issues with disk space, permissions, and network filesystems." +type: reference +domain: tdarr +tags: [tdarr, docker, server, sqlite, storage, upgrade] +--- + # Tdarr Server Setup Example ## Directory Structure diff --git a/tdarr/scripts/CONTEXT.md b/tdarr/scripts/CONTEXT.md index 864128b..aa5db90 100644 --- a/tdarr/scripts/CONTEXT.md +++ b/tdarr/scripts/CONTEXT.md @@ -1,3 +1,11 @@ +--- +title: "Tdarr Scripts Operational Context" +description: "Overview of Tdarr automation scripts: gaming-aware scheduler, container management (Podman), cron-based scheduling engine, configuration presets, and unmapped node architecture with local NVMe cache." +type: context +domain: tdarr +tags: [tdarr, scripts, podman, cron, gaming-detection, scheduler, nvidia, automation] +--- + # Tdarr Scripts - Operational Context ## Script Overview diff --git a/tdarr/scripts/README.md b/tdarr/scripts/README.md index c1ae122..7e22f7d 100644 --- a/tdarr/scripts/README.md +++ b/tdarr/scripts/README.md @@ -1,3 +1,11 @@ +--- +title: "Tdarr Gaming-Aware Scheduler" +description: "User-facing README for the Tdarr gaming-aware scheduler system: quick start, preset configurations (night-only, work-safe, weekend-heavy, gaming-only), gaming process detection, cron setup, and troubleshooting." +type: guide +domain: tdarr +tags: [tdarr, scheduler, gaming-detection, cron, podman, gpu] +--- + # Tdarr Gaming-Aware Scheduler Intelligent Tdarr node management with automatic gaming detection and flexible time-based scheduling. diff --git a/tdarr/troubleshooting.md b/tdarr/troubleshooting.md index 76c7841..4801a40 100644 --- a/tdarr/troubleshooting.md +++ b/tdarr/troubleshooting.md @@ -1,3 +1,11 @@ +--- +title: "Tdarr Troubleshooting Guide" +description: "Solutions for common Tdarr issues: forEach plugin errors, staging timeouts, kernel crashes, gaming detection, node registration, GPU utilization, DB requeue workarounds, flow plugin bugs (subtitle disposition, commentary track filtering), and Roku playback hangs." +type: troubleshooting +domain: tdarr +tags: [tdarr, troubleshooting, ffmpeg, flow-plugin, sqlite, roku, jellyfin, nvenc, cifs] +--- + # Tdarr Troubleshooting Guide ## forEach Error Resolution diff --git a/tdarr/ubuntu-manticore-setup.md b/tdarr/ubuntu-manticore-setup.md index 82217fa..7ac745a 100644 --- a/tdarr/ubuntu-manticore-setup.md +++ b/tdarr/ubuntu-manticore-setup.md @@ -1,3 +1,11 @@ +--- +title: "Tdarr Ubuntu-Manticore Setup" +description: "Setup guide for Tdarr server and GPU node on ubuntu-manticore (10.10.0.226) with GTX 1070, including Docker Compose config, GPU/NVENC capabilities, B-frame limitations, migration steps from old server, and performance benchmarks." +type: guide +domain: tdarr +tags: [tdarr, ubuntu-manticore, docker, nvidia, gtx-1070, nvenc, hevc, migration] +--- + # Tdarr Setup on ubuntu-manticore ## Overview diff --git a/vm-management/CONTEXT.md b/vm-management/CONTEXT.md index 85667d9..cb21eb3 100644 --- a/vm-management/CONTEXT.md +++ b/vm-management/CONTEXT.md @@ -1,3 +1,11 @@ +--- +title: "VM Management Overview" +description: "Technology context for Proxmox VM management including host details (PVE 8.4.16), IaC patterns with cloud-init, security architecture, resource sizing standards, and lifecycle workflows." +type: context +domain: vm-management +tags: [proxmox, vm, cloud-init, docker, ssh, infrastructure-as-code] +--- + # Virtual Machine Management - Technology Context ## Overview diff --git a/vm-management/examples/proxmox-automation.md b/vm-management/examples/proxmox-automation.md index 8e2731b..b0d638e 100644 --- a/vm-management/examples/proxmox-automation.md +++ b/vm-management/examples/proxmox-automation.md @@ -1,3 +1,11 @@ +--- +title: "Proxmox Automation Examples" +description: "Working examples for Proxmox VM automation: cloud-init deployment, post-install scripting, bulk provisioning, Docker service deployment, VM template creation, and health check scripts." +type: reference +domain: vm-management +tags: [proxmox, automation, cloud-init, docker, templates, examples] +--- + # Proxmox VM Automation - Complete Examples Complete working examples for automated VM provisioning in Proxmox environments using cloud-init and post-installation scripts. diff --git a/vm-management/examples/troubleshooting.md b/vm-management/examples/troubleshooting.md index c5a6356..26bcae4 100644 --- a/vm-management/examples/troubleshooting.md +++ b/vm-management/examples/troubleshooting.md @@ -1,3 +1,11 @@ +--- +title: "VM Troubleshooting Examples" +description: "Detailed troubleshooting examples for Proxmox VM provisioning failures, SSH connectivity issues, Docker installation problems, network/DNS configuration, disk space, and emergency recovery procedures." +type: troubleshooting +domain: vm-management +tags: [proxmox, troubleshooting, ssh, docker, cloud-init, networking, recovery] +--- + # VM Management Troubleshooting Guide Complete troubleshooting guide for Proxmox VM provisioning, SSH connectivity, Docker installation, and common configuration issues. diff --git a/vm-management/lxc-migration-plan.md b/vm-management/lxc-migration-plan.md index d9cc35c..40c6707 100644 --- a/vm-management/lxc-migration-plan.md +++ b/vm-management/lxc-migration-plan.md @@ -1,3 +1,11 @@ +--- +title: "LXC Migration Plan" +description: "Comprehensive plan for migrating Proxmox VMs to LXC containers across 6 waves. Covers assessment, technical decisions (networking, storage, Docker-in-LXC), implementation checklists, risk management, and resource planning." +type: guide +domain: vm-management +tags: [proxmox, lxc, migration, docker, apparmor, containers, planning] +--- + # VM to LXC Migration Plan - Proxmox Infrastructure **Created**: 2025-01-12 diff --git a/vm-management/migration-quick-start.md b/vm-management/migration-quick-start.md index 16eccf3..e7bca91 100644 --- a/vm-management/migration-quick-start.md +++ b/vm-management/migration-quick-start.md @@ -1,3 +1,11 @@ +--- +title: "LXC Migration Quick Start" +description: "Quick reference for VM-to-LXC migration on Proxmox: wave order, LXC creation commands, Docker volume migration, cutover process, and rollback procedures." +type: runbook +domain: vm-management +tags: [proxmox, lxc, migration, docker, containers] +--- + # VM to LXC Migration - Quick Start Guide **Status**: Approved & Ready for Execution diff --git a/vm-management/proxmox-upgrades/proxmox-7-to-9-upgrade-plan.md b/vm-management/proxmox-upgrades/proxmox-7-to-9-upgrade-plan.md index d07ae3e..e806ce5 100644 --- a/vm-management/proxmox-upgrades/proxmox-7-to-9-upgrade-plan.md +++ b/vm-management/proxmox-upgrades/proxmox-7-to-9-upgrade-plan.md @@ -1,3 +1,11 @@ +--- +title: "Proxmox 7-to-9 Upgrade Plan" +description: "Two-phase Proxmox upgrade plan (7→8→9) with Phase 1 completed (2026-02-19). Covers backup procedures, upgrade execution, service startup order, lessons learned, rollback procedures, and Phase 2 planning." +type: runbook +domain: vm-management +tags: [proxmox, upgrade, pve, backup, rollback, infrastructure] +--- + # Proxmox VE Upgrade Plan: 7.1-7 → 9.1 ## Executive Summary diff --git a/vm-management/scripts/CONTEXT.md b/vm-management/scripts/CONTEXT.md index c5458e6..bd9c4ad 100644 --- a/vm-management/scripts/CONTEXT.md +++ b/vm-management/scripts/CONTEXT.md @@ -1,3 +1,11 @@ +--- +title: "VM Scripts Context" +description: "Operational context for VM/LXC provisioning scripts: vm-post-install.sh, cloud-init templates, fix-docker-apparmor.sh, and lxc-docker-create.sh. Includes usage patterns, SSH key integration, and troubleshooting." +type: context +domain: vm-management +tags: [proxmox, scripts, provisioning, cloud-init, docker, apparmor, lxc, ssh] +--- + # VM Management Scripts - Operational Context ## Script Overview diff --git a/vm-management/scripts/LXC-MIGRATION-GUIDE.md b/vm-management/scripts/LXC-MIGRATION-GUIDE.md index 0527c31..e218407 100644 --- a/vm-management/scripts/LXC-MIGRATION-GUIDE.md +++ b/vm-management/scripts/LXC-MIGRATION-GUIDE.md @@ -1,3 +1,11 @@ +--- +title: "LXC Migration Automation Guide" +description: "Step-by-step guide for using lxc-docker-create.sh and fix-docker-apparmor.sh to migrate VMs to LXC containers. Includes complete workflow, data migration commands, time estimates, and troubleshooting." +type: runbook +domain: vm-management +tags: [proxmox, lxc, migration, docker, apparmor, scripts, automation] +--- + # LXC Migration Automation Scripts This guide covers automation scripts for migrating VM-based Docker containers to LXC containers. diff --git a/vm-management/scripts/README.md b/vm-management/scripts/README.md index 87d6fd7..60db84b 100644 --- a/vm-management/scripts/README.md +++ b/vm-management/scripts/README.md @@ -1,3 +1,11 @@ +--- +title: "VM Provisioning Scripts" +description: "Usage guide for vm-post-install.sh and cloud-init-user-data.yaml. Covers automated VM provisioning with SSH key deployment, Docker installation, security hardening, and post-provisioning verification." +type: reference +domain: vm-management +tags: [proxmox, scripts, provisioning, cloud-init, docker, ssh] +--- + # VM Management and Provisioning Automated VM provisioning scripts for Proxmox environments with SSH key deployment, system updates, and Docker installation. diff --git a/vm-management/troubleshooting.md b/vm-management/troubleshooting.md index 8fa173c..b513f32 100644 --- a/vm-management/troubleshooting.md +++ b/vm-management/troubleshooting.md @@ -1,3 +1,11 @@ +--- +title: "VM Management Troubleshooting" +description: "Troubleshooting guide for Proxmox VM issues: cloud-init failures, SSH access problems, Docker installation errors, network configuration, disk space, and emergency recovery procedures." +type: troubleshooting +domain: vm-management +tags: [proxmox, vm, ssh, docker, cloud-init, networking, recovery] +--- + # Virtual Machine Management Troubleshooting Guide ## VM Provisioning Issues diff --git a/vm-management/wave1-migration-results.md b/vm-management/wave1-migration-results.md index f46962c..ed69e81 100644 --- a/vm-management/wave1-migration-results.md +++ b/vm-management/wave1-migration-results.md @@ -1,3 +1,11 @@ +--- +title: "Wave 1 Migration Results" +description: "Results from migrating docker-7days game server (VM 111 to LXC 211). Documents AppArmor fix for Docker-in-LXC, disk sizing lessons, and the validated migration process used for subsequent waves." +type: reference +domain: vm-management +tags: [proxmox, lxc, migration, docker, apparmor, game-server] +--- + # Wave 1 Migration Results - docker-7days (VM 111 → LXC 211) **Date**: 2025-01-12 diff --git a/vm-management/wave2-migration-results.md b/vm-management/wave2-migration-results.md index 313b43a..133827d 100644 --- a/vm-management/wave2-migration-results.md +++ b/vm-management/wave2-migration-results.md @@ -1,3 +1,11 @@ +--- +title: "Wave 2 Migration Results" +description: "Results from migrating docker-vpn (VM 121) to arr-stack LXC 221. Documents VPN elimination rationale, Overseerr-to-Jellyseerr switch, and arr stack (Sonarr/Radarr/Readarr/SABnzbd) deployment." +type: reference +domain: vm-management +tags: [proxmox, lxc, migration, docker, arr-stack, sonarr, radarr, jellyseerr, usenet] +--- + # Wave 2 Migration Results - docker-vpn (VM 121 → LXC 221 arr-stack) **Date**: 2025-12-05 diff --git a/workstation/CONTEXT.md b/workstation/CONTEXT.md index 5410ab5..a071fa7 100644 --- a/workstation/CONTEXT.md +++ b/workstation/CONTEXT.md @@ -1,3 +1,11 @@ +--- +title: "Workstation Configuration" +description: "Workstation dotfiles management via symlinks, fish shell setup with custom functions and tmux helpers, systemd user timers, and Claude Code integration overview." +type: context +domain: workstation +tags: [dotfiles, fish, starship, tmux, symlink, systemd, claude-code, workstation] +--- + # Workstation Configuration ## Dotfiles Repository diff --git a/workstation/claude-code-config.md b/workstation/claude-code-config.md index 9a95fa6..7adb26a 100644 --- a/workstation/claude-code-config.md +++ b/workstation/claude-code-config.md @@ -1,3 +1,11 @@ +--- +title: "Claude Code Configuration" +description: "Reference for Claude Code config file locations and precedence, MCP server setup in ~/.claude.json, hooks, permissions, and common gotchas." +type: reference +domain: workstation +tags: [claude-code, mcp, config, hooks, permissions, claude] +--- + # Claude Code Configuration ## Config File Locations @@ -43,10 +51,10 @@ MCP servers are defined in the top-level `mcpServers` key of `~/.claude.json`: } ``` -**url** — remote HTTP server (Streamable HTTP transport): +**http** — remote HTTP server (Streamable HTTP transport): ```json { - "type": "url", + "type": "http", "url": "http://host:port/mcp", "headers": { "Authorization": "Bearer "