https://homelab.nbkelley.com/tags/architecture/ Recent content in Architecture on homelab Hugo en Sat, 02 May 2026 00:00:00 +0000 https://homelab.nbkelley.com/docs/ai/wiki-system/ Sat, 02 May 2026 00:00:00 +0000 https://homelab.nbkelley.com/docs/ai/wiki-system/ <h1 id="wiki-system---architecture">Wiki System - Architecture<a class="anchor" href="#wiki-system---architecture">#</a></h1> <h2 id="what-was-established">What Was Established<a class="anchor" href="#what-was-established">#</a></h2> <p>The wiki system is designed around the LLM wiki pattern (Karpathy): raw sources (chat transcripts, notes, docs) are crystallized into structured markdown pages, embedded into pgvector, and retrieved semantically by agents in future sessions. A dedicated LXC (<code>nk-wiki</code>) will host the wiki VM, separating wiki infrastructure from other services.</p> <h2 id="multi-wiki-namespace-design">Multi-Wiki Namespace Design<a class="anchor" href="#multi-wiki-namespace-design">#</a></h2> <p>Three wikis are planned, each with its own namespace in pgvector:</p> https://homelab.nbkelley.com/docs/infrastructure/web_server_architecture/ Wed, 26 Mar 2025 00:00:00 +0000 https://homelab.nbkelley.com/docs/infrastructure/web_server_architecture/ <h1 id="web-server-architecture-on-proxmox">Web Server Architecture on Proxmox<a class="anchor" href="#web-server-architecture-on-proxmox">#</a></h1> <h2 id="what-was-established">What Was Established<a class="anchor" href="#what-was-established">#</a></h2> <p>High-level architectural strategies for deploying web development environments on Proxmox, focusing on balancing isolation with resource efficiency.</p> <h2 id="key-decisions">Key Decisions<a class="anchor" href="#key-decisions">#</a></h2> <ul> <li><strong>LXC for Services</strong>: Use LXC containers for lightweight, single-purpose services (e.g., Nginx, Databases) to minimize overhead.</li> <li><strong>VM for Complex Workloads</strong>: Use full VMs when running Docker, Kubernetes, or when custom kernel modules are required.</li> <li><strong>Reverse Proxy Pattern</strong>: Always use a reverse proxy (Nginx Proxy Manager, Traefik, or C/Caddy) to handle SSL termination and route traffic to multiple internal services.</li> <li><strong>Database Isolation</strong>: Separate databases into their own containers/VMs to improve security and facilitate independent backups.</li> </ul> <h2 id="current-configuration">Current Configuration<a class="anchor" href="#current-configuration">#</a></h2> <h3 id="networking-patterns">Networking Patterns<a class="anchor" href="#networking-patterns">#</a></h3> <ul> <li><strong>Bridge Mode</strong>: Default <code>vmbr0</code> for services requiring LAN access.</li> <li><strong>Internal Network</strong>: Use secondary bridges (e.g., <code>vmbr1</code>) for isolated communication between web servers and databases.</li> </ul> <h3 id="storage-patterns">Storage Patterns<a class="anchor" href="#storage-patterns">#</a></h3> <ul> <li><strong>Local-LVM</strong>: Preferred for high-performance VM/container disks.</li> <li><strong>Directory Storage</strong>: Suitable for container volumes and simpler storage needs.</li> </ul> <h2 id="historical-notes">Historical Notes<a class="anchor" href="#historical-notes">#</a></h2> <p>This architecture plan was established in March 2025. The preference for LXCs over VMs for simple web services was a primary driver.</p>