---
project:
  name: Homelab Infrastructure
  status: active
  category: infrastructure
  source: live-verification
  created: 2026-01-06
  updated: 2026-04-23
  description: Core homelab configuration including DNS, Traefik, Authentik SSO, Proxmox, and container orchestration
  tags: [infrastructure, homelab, documentation]
---

# Homelab Infrastructure

## Overview

Multi-host homelab cluster managed via GitOps. 8 hosts across 3 VLANs running ~70 containers and systemd services.

## Architecture

- [[architecture.md|Full Architecture]] — Comprehensive infrastructure documentation with diagrams
- [[proxmox-setup.md|Proxmox]] — Hypervisor and VM management
- [[truenas-config.md|TrueNAS]] — ZFS storage configuration

## Hosts

| Host | IP | Role | Services |
|------|-----|------|----------|
| [[entities/ice|ubuntu]] | 192.168.50.61 | Primary Docker | ~70 containers, Authentik, Traefik, Gitea, monitoring |
| [[entities/grizzley|grizzley]] | 192.168.50.84 | Edge Ingress | 14 containers, Traefik HA, Jellyfin, hermes-dashboard |
| [[entities/ice|ice]] | 192.168.50.197 | Control Plane | Hermes Agent primary, OpenCode backend |
| [[entities/proxmox|proxmox]] | 192.168.50.11 | Hypervisor | ⚠️ OFFLINE |
| [[entities/truenas|truenas]] | 192.168.50.12 | NAS | ⚠️ POOL CORRUPTION |

**Full entity docs:** [[entities/index|homelab/entities/]] — detailed host and service pages with runbooks, gotchas, and cross-references.


## Services by Category

### Media
Jellyfin, Radarr, Sonarr, Lidarr, Prowlarr, Jellyseerr, qBittorrent, SABnzbd, Bazarr, Navidrome, Calibre, Kavita, Audiobookshelf, Lazylibrarian, Musicseerr, RecCollection, Unified Media Manager, Tdarr, Stremio

### Auth & SSO
Authentik (server + worker + redis)

### Monitoring
Prometheus, Grafana, Loki, Promtail, Alertmanager, Node Exporter, cAdvisor, Blackbox Exporter

### AI/Dev
Ollama, Gitea, Faster Whisper Server, Docker OSX, Qdrant, Registry

### AI Applications
AI Job Pipeline, AI Alert Aggregator, AI Media Intelligence, AI Subscriptions, Homelab Inventory

### Infrastructure
Traefik (ubuntu + grizzley), Gluetun VPN, CrowdSec

### Grizzley Services
Komodo (stack management), Hermes (Telegram agent), aiomanager, Vaultwarden, Uptime Kuma, Homepage, Minecraft Bedrock

## Related

- [[../automation/|Automation Scripts]]
- [[../platform-config/|Platform Config]]
- [[../ai-assistant/|AI Assistant]]

## Tasks
```dataview
TASK
FROM "homelab/tasks"
WHERE !completed
SORT file.name ASC
```