jazzymc/infrastructure
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
4066e7ff3ae8b5210942d5470e0f717f30bd8cb2
infrastructure/docs/06-CHANGELOG.md
XTRM-Unraid 4066e7ff3a
All checks were successful
ci/woodpecker/push/woodpecker Pipeline was successful
Details
docs: Complete local AI stack documentation 
- Deployed Ollama + Open WebUI on Unraid
- Created custom unraid-assistant model with full infrastructure knowledge:
  - Network topology (8 VLANs, all IPs/gateways)
  - 45+ Docker containers with ports and purposes
  - RouterOS 7 commands and VLAN patterns
  - Traefik labels and Authentik SSO middleware
  - All xtrm-lab.org external URLs
- Added /usr/local/bin/ai terminal helper command
- Documented RAM optimization (stopped 5 containers)
- Added future upgrade notes for Mac Mini M4

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-26 20:38:06 +02:00

4.7 KiB
Raw Blame History

Infrastructure Changelog

2026-01-26

Local AI Stack Deployed

  • [AI] Deployed Ollama container with Intel GPU passthrough
  • [AI] Deployed Open WebUI at http://192.168.31.2:3080
  • [AI] Installed qwen2.5-coder:7b base model
  • [AI] Created custom unraid-assistant model with infrastructure knowledge:
    • Network topology (all VLANs, IPs, gateways)
    • 45+ Docker containers (names, ports, purposes)
    • RouterOS 7 commands and patterns
    • Traefik labels and Authentik middleware
    • All external URLs (xtrm-lab.org)
  • [AI] Created /usr/local/bin/ai terminal helper command
  • [AI] Stopped non-critical containers for RAM: karakeep, unimus, homarr, netdisco-*

VLAN Activation Attempt & Fixes

  • [VLAN] Configured CSS326 switch VLANs via SwOS web interface
  • [VLAN] Enabled VLAN filtering on MikroTik - caused internet outage
  • [VLAN] Rolled back VLAN filtering to restore connectivity
  • [VLAN] ROOT CAUSE IDENTIFIED: Multiple configuration issues

Issues Fixed

  • [FIX] DHCP DNS now points to each VLAN gateway instead of legacy 192.168.31.1
    • VLAN 20: 192.168.20.1, VLAN 25: 192.168.25.1, etc.
  • [FIX] Added DNS redirect rules for all VLANs (src-address-list=all-vlans)
  • [FIX] Added all VLAN interfaces to LAN firewall interface list
  • [FIX] Added NAT masquerade rules for VLAN traffic to AdGuard container
  • [BACKUP] MikroTik config saved before activation attempt

Current Status

  • MikroTik: Fully configured, fixes applied, ready for activation
  • CSS326: VLANs configured, port assignments done
  • VLAN Filtering: OFF (ready to enable when convenient)
  • Next: Enable VLAN filtering + force DHCP renewal on devices

2026-01-25 (Update 3)

VLAN Phase 1 Complete

  • [VLAN] Added VLAN 25 (Kids) - interface, IP, DHCP server, pool, bridge entry
  • [VLAN] Fixed VLAN 10 (Management) leases - correct IPs per device assignment doc
  • [VLAN] Fixed VLAN 30 (IoT) leases - all 14 devices with correct IPs
  • [VLAN] Added VLAN 25 (Kids) leases - 6 devices including XTRM-Ally
  • [VLAN] Added VLAN 50 (Guest) leases - 7 unknown devices
  • [VLAN] Added firewall rules for VLAN 25 (Kids → IoT, Legacy, DNS)
  • [VLAN] Total devices configured: 44

Device Discovery

  • [NETWORK] Discovered XTRM-Ally gaming device → assigned to Kids VLAN
  • [NETWORK] Discovered Dancho Windows device → assigned to Kids VLAN
  • [NETWORK] Discovered 2x lwip0 IoT devices → assigned to IoT VLAN
  • [NETWORK] Discovered 3x unknown devices → assigned to Guest VLAN

Documentation Updates

  • [DOCS] Updated 03-VLAN-DEVICE-ASSIGNMENT.md - complete device inventory (44 devices)
  • [DOCS] Updated 11-VLAN-IMPLEMENTATION.md - Phase 1 complete status
  • [DOCS] All VLANs now documented: 10, 20, 25, 30, 35, 40, 50

Next Steps

  • CSS326 switch VLAN configuration via SwOS
  • Enable VLAN filtering on MikroTik bridge
  • Test connectivity

2026-01-25

VLAN Implementation (Prepared)

  • [VLAN] Created 6 VLANs on MikroTik bridge (10, 20, 30, 35, 40, 50)
  • [VLAN] Configured IP addresses for all VLAN interfaces
  • [VLAN] Created DHCP servers and pools for each VLAN
  • [VLAN] Added static DHCP leases mapping MACs to VLAN IPs
  • [VLAN] Configured bridge VLAN table with tagged/untagged ports
  • [VLAN] Set WiFi ports PVID=20 (Trusted VLAN default)
  • [VLAN] Added inter-VLAN firewall rules (active)
  • [VLAN] VLAN filtering NOT YET ENABLED (pending CSS326 switch config)
  • [DOCS] Added docs/11-VLAN-IMPLEMENTATION.md
  • [SCRIPTS] Added scripts/mikrotik-vlan-setup.rsc
  • [SCRIPTS] Added scripts/mikrotik-vlan-enable.rsc

MikroTik Containers

  • [CONTAINER] AdGuard Home container running on MikroTik
  • [CONTAINER] Tailscale container configured (inactive)
  • [CONTAINER] Container bridge (containers-br) with NAT

DNS Configuration

  • [DNS] AdGuard Home as primary DNS (172.17.0.2)
  • [DNS] DNS redirect rules for all clients
  • [DNS] DoT/DoH upstream configured in AdGuard

Previous Changes

See git history for earlier changes.

2026-01-25 (Update 2)

DNS Configuration

Containers

  • [CONTAINER] Fixed Tailscale container authentication
  • [CONTAINER] Tailscale DNS changed from 8.8.8.8 to 172.17.0.1,1.1.1.1 (fallback)
  • [CONTAINER] Tailscale route fixed: 100.64.0.0/10 → 172.17.0.3

Documentation

  • [DOCS] Created 02-PORT-UTILIZATION.md with ASCII port diagrams
  • [DOCS] Updated 09-MIKROTIK-ADGUARD-DOT-DOH.md with Quad9 DoH config

Network

  • [NETWORK] Enabled CSS326 SFP1 port - 10G backbone link to ZX1 now active

Documentation Fix

  • [DOCS] Fixed ZX1 switch IP: 192.168.31.22 (was incorrectly documented as .7)
Reference in New Issue View Git Blame Copy Permalink