homelab-blueprint
Blueprint para homelab con Proxmox VE en dos nodos: MediaServer y AIServer. Documenta arquitectura de Docker, LXCs, IA local con Ollama/ROCm y gestión de medios. Incluye React PWA, automatización y recuperación ante desastres.
Ficha actualizada 27 sept 2026, 8:33 · upstream 27 sept 2026, 8:25 · release sin release detectada
Qué es homelab-blueprint
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este repositorio documenta una infraestructura de homelab basada en Proxmox VE distribuida en dos nodos dedicados: MediaServer y AIServer. La arquitectura elimina el nodo histórico de gaming, enfocándose en automatización doméstica, IA local y gestión de medios. Utiliza LXCs para aislamiento lógico y Docker para servicios, soportando passthrough de GPU AMD para inferencia local e investigación con ROCm.
La capa de servicio se basa en Next.js y React, ofreciendo una interfaz unificada vía PWA móvil y escritorio. Integra gestión de medios con almacenamiento btrfs, almacenamiento masivo y backups cifrados con Restic. La red utiliza Tailscale para acceso seguro interno y MagicDNS para resolución estable.
El sistema incluye agentes autónomos para monitorización y reparación, junto con herramientas de productividad como Grimoire y Lectern. Es una documentación de arquitectura (blueprint) y no un despliegue automático, requiriendo configuración manual de hardware, red y almacenamiento antes del uso productivo.
- Automatización doméstica e IA local con Ollama en hardware AMD
- Servidor multimedia autocontenido con gestión de bibliotecas y descargas
- Entorno de desarrollo compartido con LXCs dedicados a proyectos
- Gestión de juegos en red privada mediante servidores dedicados
- Automatización de backups y recuperación ante desastres con Restic
- Soporte nativo para inferencia local con ROCm en GPUs AMD
- Arquitectura modular combinando LXCs y Docker para aislamiento
- Gestión de agentes autónomos para monitorización y reparación del sistema
- Seguridad perimetral robusta con Tailscale, Authelia y certificados locales
- Requiere hardware específico (AMD) para aprovechar la capa de IA local
- No es un despliegue one-click, necesita configuración manual de red y almacenamiento
- El clúster de dos nodos requiere QDevice para alta disponibilidad real
- Gestión manual de actualizaciones de modelos de lenguaje y drivers GPU
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Verificar compatibilidad de hardware antes de instalar Proxmox, especialmente para passthrough de GPU. Configurar MagicDNS y Tailscale para nombres estables en la red interna. Revisar permisos de acceso a /dev/dri y /dev/kfd en los LXCs dedicados a IA. Implementar QDevice si se requiere alta disponibilidad entre nodos. Consultar la documentación de recuperación ante desastres antes de ejecutar backups críticos.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.