device-setup/CLAUDE.md

3 KiB
Raw Permalink Blame History

KiteStacks — Claude Context

You are working with kenpat on the KiteStacks homelab project on samurai (Windows 11 gaming desktop).

Who kenpat is

  • Building the KiteStacks homelab (kitestacks.com) — live production multi-host platform
  • Currently studying CompTIA A+ Core 2, exam goal before July 4th week (hard deadline July 12 2026)
  • Passed A+ Core 1 with highest score in class of 22
  • Cert path: A+ Core 2 → CCNA → AWS SAA → AWS SysOps → CKA → AI
  • Career goal: Cloud Engineering
  • Class schedule: Mon/Wed in-person 9am3/4pm, Tue/Thu/Fri remote
  • Uses Uber to earn money short-term (parking fees and bills)

This Device

  • samurai — Windows 11 gaming desktop, AMD Ryzen 7 7800X3D, 31GB RAM
  • Tailscale IP: 100.74.0.109
  • Connected to monk (primary homelab host) over Tailscale

Key Devices

Device OS Tailscale IP Role
monk Linux (Debian) 100.85.209.116 Primary homelab host, T14s travel laptop
samurai Windows 11 100.74.0.109 Gaming desktop, study machine
kscloud1 Linux (Hetzner VPS) 100.123.254.52 Cloud replica, shared Authentik DB

Private Repos on Forgejo (ssh://git@100.85.209.116:2222/kenpat/)

Repo Purpose
kitestacks-homelab Main homelab RUNBOOK, docs, architecture
homelab-mastery Complete learning guide — concepts, certs, interview prep
study-tracker A+ Core 2 study log, practice test scores, cert roadmap
obsidian-vault Personal notes, commands, study log (synced across devices)
device-setup Setup scripts for all devices (this repo)

Pull full context

# Clone all repos for full picture
git clone ssh://git@100.85.209.116:2222/kenpat/homelab-mastery.git ~/homelab-mastery
git clone ssh://git@100.85.209.116:2222/kenpat/study-tracker.git ~/study-tracker
git clone ssh://git@100.85.209.116:2222/kenpat/obsidian-vault.git ~/obsidian-vault

Homelab Quick Facts

  • 9 public subdomains at kitestacks.com behind Cloudflare Tunnel
  • Active-active failover: monk + kscloud1 both serve all 9 services
  • SSO via Authentik (shared Postgres+Redis on kscloud1 over Tailscale)
  • Portal (www.kitestacks.com) is custom nginx static site with Python metrics API
  • Forgejo runs on monk at gitforge.kitestacks.com (SSH port 2222)

Current In-Progress Tasks

  • samurai Obsidian setup: vault cloned, plugins (Git + Pomodoro Timer) still need to be installed manually
  • Portainer SSO: Authentik side done, pending Cloudflare tunnel hostname + Portainer OAuth UI config
  • Oracle Cloud migration: kscloud1 (Hetzner) to be replaced by Oracle VPS (no firm date)
  • Phase 2: Obsidian mind map → HTML mind map sync for homelab portal

Study Log (A+ Core 2)

  • Started: 2026-06-11 9:15 PM
  • Diagnostic: 50% on Sybex (cold, no prior study)
  • Next test: CompTIA CertMaster (week of 2026-06-16)
  • Full log: ~/study-tracker/certifications/a-plus-core2.md

Security Rules

  • Never commit IPs, ports, or passwords to any Forgejo repo
  • Use placeholders: <IP_REDACTED>, ,
  • .env files never committed