docs: add YAML frontmatter to all 151 markdown files
All checks were successful
Reindex Knowledge Base / reindex (push) Successful in 3s

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 <noreply@anthropic.com>
This commit is contained in:
Cal Corum 2026-03-12 09:00:44 -05:00
parent c5dc5d96a6
commit 4b7eca8a46
147 changed files with 1176 additions and 9 deletions

View File

@ -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

View File

@ -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

View File

@ -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.

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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 |

View File

@ -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 |

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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 |

View File

@ -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 |

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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.

View File

@ -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.

View File

@ -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

View File

@ -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

View File

@ -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.

View File

@ -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

View File

@ -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

View File

@ -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.

View File

@ -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

View File

@ -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.

View File

@ -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.

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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.

View File

@ -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.

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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.

View File

@ -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/**

View File

@ -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.

View File

@ -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.

View File

@ -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.

View File

@ -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.

View File

@ -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

View File

@ -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.

View File

@ -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.

View File

@ -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

View File

@ -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

View File

@ -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.

View File

@ -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

View File

@ -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

View File

@ -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.

View File

@ -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.

View File

@ -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`.

View File

@ -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.

View File

@ -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.

View File

@ -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**

Some files were not shown because too many files have changed in this diff Show More