homelab
Infraestructura self-hosted para homelab con Docker Compose, ZFS, Pi-hole/Unbound, WireGuard y servicios como Jellyfin, Immich, Home Assistant. Incluye documentación exhaustiva sobre arquitectura, runbooks de mantenimiento y prácticas de seguridad hardening.
Ficha actualizada 28 sept 2026, 13:46 · upstream 28 sept 2026, 13:37 · release sin release detectada
Qué es homelab
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este repositorio documenta una infraestructura de servidor doméstico diseñada para producción real con enfoque en disponibilidad, versionado de configuraciones y análisis de fallos. La arquitectura utiliza Docker Compose para orquestación, ZFS como sistema de archivos con configuración optimizada (ashift=12, recordsize=1M, atime=off), y Pi-hole/Unbound para filtrado DNS sin dependencia de terceros.
Los servicios incluyen Jellyfin para streaming multimedia, Immich para backup fotográfico, WireGuard para acceso remoto seguro, Uptime Kuma para monitorización, Scrutiny para salud de discos SMART, Home Assistant para automatización doméstica, y Open WebUI con Ollama para inferencia local de LLMs. El diseño de red implementa IPs estáticas, DHCP reservations, y aislamiento de redes Docker con direccionamiento fijo.
La documentación incluye runbooks detallados sobre problemas diagnosticados (fallback DNS silencioso, VPN que sobrescribe /etc/resolv.conf, alertas falsas de discos, páginas de estado inconsistentes), decisiones de arquitectura, y prácticas de seguridad como hardening de reverse proxy, TLS, fail2ban, y auditoría de supply-chain.
- Servidor multimedia self-hosted con Jellyfin para streaming a dispositivos domésticos
- Backup y gestión fotográfica auto-alojada con Immich sin depender de servicios en la nube
- Acceso remoto seguro mediante WireGuard con autenticación y cifrado end-to-end
- Monitorización completa de infraestructura con Uptime Kuma, Scrutiny y alertas a ntfy
- Automatización doméstica local-first con Home Assistant sin dependencia de APIs externas
- Inferencia local de LLMs con Open WebUI + Ollama en arquitectura wake-on-demand GPU
- Configuración ZFS optimizada con ashift=12, recordsize=1M y atime=off para maximizar vida útil de discos
- Documentación exhaustiva con runbooks que incluyen root-cause analysis de problemas reales diagnosticados
- Arquitectura de red segura con Pi-hole/Unbound sin fallback a DNS externos por defecto
- Prácticas de seguridad hardening: TLS, fail2ban, account lockouts y wildcard certs para split-horizon DNS
- Sistema de backups versionados en Git con sanitización automática de configuraciones Portainer
- Control granular de ejecución de comandos en LLMs con allowlists, approvals humanos y sin shell
- Requiere hardware específico: Dell Precision o equivalente con soporte ZFS y GPU opcional para LLMs
- Dependencia de Ubuntu Server headless con NetworkManager para gestión de red estática
- Algunas funcionalidades avanzadas (Windows/AD lab) marcadas como 'in progress' sin documentación completa
- Configuraciones específicas para hardware Dell que podrían requerir adaptación a otras plataformas
- Requiere conocimientos avanzados de Docker Compose, ZFS y gestión de sistemas Linux
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.
Despliegue recomendado: Ubuntu Server LTS con ZFS pool en mirror (ashift=12), 4 núcleos CPU mínimo, 8GB RAM. Configurar IPs estáticas en LAN con DHCP reservation. Iniciar Docker Compose stacks desde configs/ con restart: unless-stopped. Implementar WireGuard para acceso remoto antes de exponer servicios públicos. Revisar docs/storage-zfs.md y docs/runbooks/ antes de producción.
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.