fogserv.cloud Knowledge Base
Status: Active
Last Updated: 2026-08-26
Category: KB Root Index
Prerequisites: None
Tags: kb, index, knowledge-base, fogserv
Summary
The living memory of fogserv.cloud: course-style documentation for running self-hosted, AI-managed infrastructure — from Linux basics through GitOps, observability, and the agentic operations vision. The site you're reading is this knowledge base; every file under kb/ renders at a matching URL.
How to Use This KB
- New here? Start with Basics → Day 1: New Developer, then follow each section's numbered index in order.
- Every section page is an index: visiting
/networking,/cicd, etc. shows that section's articles in curriculum order (driven by its README), plus the full section notes. - Global navigation: the sidebar on the home page lists every section and article; article pages have an "On this page" table of contents.
- Agents: update the relevant section after any session that changes code or ops state. Follow the lesson header format (Status / Last Updated / Category / Prerequisites / Time / Tags → Summary → body → Sources → Change Log).
Learning Path
Basics → Containers → Networking → Security → Infrastructure
→ CI/CD → Observability → Cloud → AI/ML → GitOps
→ Languages → Runtime → Backend → SQL → Web
→ Sysadmin → Agentic → Databases → Frontend
→ Sysadmin → Agentic → Databases → Frontend
→ Migrations → Research → Fogserv (this project)
Directory Map
Root-level project documents live alongside these sections:
- TELOS — North Star philosophy: mission, pillars (GitOps / Ticketing / Documentation / Proactive Polish)
- agent — agent operating reference: structure, workflows, troubleshooting rules
- tasks — phased project roadmap and current sprint focus
- lessons-learned — session insights and tools that exceeded expectations
- problems-solved — errors encountered, root causes, fixes, prevention
- implementations — architecture decisions and trade-offs
- workflows — planning / implementation / validation / documentation loops
- wireframes — MVP UX flows and component wireframes
- kb-build-plan — the build-out roadmap behind this KB
- Apps — every fogserv.cloud project (Vault, Dia, Prompts, Self-Help, Homelab, QR Generator, Kids Learning)
- Updates — changelog & release notes entry point
The Sections
| Section | Focus | Status |
|---|---|---|
| ⚡ Basics | Onboarding, Linux, SSH, CLI, Git, Bash | ✅ Complete (8 lessons) |
| 🐳 Containers | Docker fundamentals → k0s production | ~85% built · 24 articles |
| 🌐 Networking | TCP/IP, DNS, reverse proxies, firewalls, monitoring | ✅ Complete · 20 articles |
| 🔒 Security | Hardening, TLS/PKI, firewalls, IDS, Vault, zero trust | ~54% built · 18 articles |
| 🏗️ Infrastructure | IaC: Terraform, Ansible, Packer, cloud-init, DR | ~65% built · 26 articles |
| 🚀 CI/CD | Forgejo + Woodpecker, pipelines, deployment, rollback | ✅ Complete · 21 articles |
| 📊 Observability | Prometheus, Grafana, Loki, alerting, tracing | ✅ Complete · 11 articles |
| ☁️ Cloud | MinIO, S3, Nextcloud, restic, media servers, backups | ✅ Complete · 14 articles |
| 🧠 AI/ML | Ollama, embeddings, Qdrant, RAG pipelines | ✅ Complete · 15 articles |
| 📝 Languages | TypeScript, Python, Go, Rust, C++, PHP fundamentals | ✅ Complete · 6 articles |
| ⚡ Runtime | Bun (primary), Node, event loop & internals | ✅ Complete · 3 articles |
| 🔌 Backend | HTTP servers, routing, middleware, REST APIs | ✅ Complete · 8 articles |
| 🗃️ SQL | SELECT, joins, aggregation, schema, transactions | ✅ Complete · 5 articles |
| 🌐 Web | HTML, DOM, CSS, browser JavaScript, frontend tooling | ✅ Complete · 5 articles |
| ⚙️ GitOps | Drift detection, merge strategies, policy as code | ✅ Complete · 4 articles |
| 🛠️ Sysadmin | Access control, secrets hygiene, schedulers, logs | ✅ Complete · 5 articles |
| 🤖 Agentic | AI-managed server vision, multi-agent workflows | ✅ Complete · 4 articles |
| 🗄️ Databases | Prisma practices, schema, SQLite/postgres tuning | ✅ Complete · 8 articles |
| 🎨 Frontend | TanStack/Tailwind site patterns, testing | ✅ Complete · 6 articles |
| 🔄 Migrations | Cloud-to-self-hosted playbooks, Ghost import map | Syllabus + planning · 5 articles |
| 🔬 Research | Living log of external sources behind decisions | Active log · 7 notes |
| 🏠 Fogserv | This stack: architecture, deploy runbook, KB browser | ✅ Complete · 3 articles |
Conventions
- One topic per file; filename = slug (e.g.
kb/networking/wireguard-setup.md→/networking/wireguard-setup). - Every section has a
README.mdthat doubles as its syllabus; keep curriculum links there in teaching order. - Never delete articles — mark
Status: Deprecatedand link the replacement. - Cross-link generously with relative
.mdlinks; they render as clean URLs.