Skip to content
Architecture

Homelab

A personal infrastructure project running 24/7 on a single NAS. Development lab, home automation hub, and AI agent orchestration platform.

20+ Docker containers24/7 uptime3 protocols (Zigbee, WiFi, miio)5 AI agents

Network topology

Internet
   │
   ├── VPN ── Acceso remoto
   │
Router
   │
   ├── NAS
   │   ├── Contenedores (+20)
   │   │   ├── Domótica
   │   │   ├── Servidor de medios
   │   │   ├── DNS / Bloqueo de anuncios
   │   │   └── Herramientas de desarrollo
   │   └── Agentes de IA (×5)
   │       ├── Orquestación
   │       ├── Desarrollo
   │       ├── Trading
   │       └── Medios
   │
   └── Dispositivos IoT
       ├── Zigbee
       ├── WiFi
       └── miio
What it is

Personal infrastructure in 24/7 production.

A single NAS running 20+ containerized services. Combines development lab, multi-protocol smart home hub, and AI agent orchestration platform. Fully self-hosted, fully managed with Docker Compose.

Architecture decisions

Every decision has a why.

  • Docker Compose over Kubernetes: single node, simplicity wins
  • SSD for databases, HDD for media: cost/performance tradeoff
  • DNS-level ad blocking: network-wide, zero client config
  • Mesh VPN for remote access: no exposed ports, no router changes
  • Multi-agent AI system: specialized agents per domain
Numbers

Infrastructure in data.

  • 20+ containers in production
  • 24/7 uptime
  • 3 smart home protocols (Zigbee, WiFi, miio)
  • 5 specialized AI agents
  • Remote access from any network
Multi-agent system

The differentiator: specialized AI running locally.

A multi-agent system runs directly on the NAS. Each agent has a clear domain: development, trading, media, orchestration, each with its own tools and context. They communicate in real time and coordinate tasks autonomously. The design decision was specialization over generalization: agents with bounded domains instead of a monolithic model. Result: contained errors, parallel coordination, and horizontal scaling by capability.

  • Specialized agents with separate domains
  • Real-time inter-agent communication
  • Autonomous coordination without human intervention
  • Persistent services with automatic startup
Live architecture
Click a service to see what it does
Infrastructure (4)
Media (1)
Smart Home (3)
AI & Agents (2)
🖥️
UGREEN NAS
🔗
Tailscale
🛡️
AdGuard
📁
Samba
🎬
Plex
🏠
Home Assistant
📡
Zigbee2MQTT
📬
Mosquitto
🐙
OpenClaw
📊
Mahoraga
Select a node