homelab
Homelab repositorio con servicios auto-alojados en Proxmox usando LXC y Docker Compose, incluyendo IA, media, productividad y observabilidad.
Ficha actualizada 22 sept 2026, 22:55 · upstream 22 sept 2026, 22: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 contiene plantillas de Ansible y archivos de configuración para un homelab completamente auto-alojado ejecutándose sobre Proxmox. Cada servicio corre en su propio contenedor LXC basado en Ubuntu, con Ansible encargado del despliegue mediante Docker y docker-compose.yml. El tráfico se gestiona a través de Tailscale (VPN mesh), y los logs se centralizan en Loki a través de Grafana Alloy.
La arquitectura prioriza la resiliencia y el aislamiento: cada LXC es independiente, lo que permite snapshots, migraciones y backups granulares sin afectar servicios dependientes. Proxmox actúa como nodo central para la gestión de contenedores, mientras que los contenedores individuales se encargan de sus operaciones internas.
Los servicios principales incluyen un stack de IA (Immich con reconocimiento facial, Paperless-ngx), media (Jellyfin, Navidrome, Audiobookshelf, Sonarr/Radarr), herramientas de productividad (Miniflux, ArchiveBox, Kiwix), dashboards personalizados (Homepage, Beszel) y observabilidad completa (Grafana Alloy + Loki + Gatus). La infraestructura también incluye un proxy público vía Pangolin para servicios que requieren acceso externo.
El enfoque técnico se basa en una arquitectura de microservicios ligeros donde cada contenedor LXC es autónomo pero conectado a través de Tailscale, eliminando la necesidad de portas SSH abiertas en internet. Los logs están etiquetados por host y unidad para facilitar el análisis centralizado.
- Gestionar un ecosistema multimedia completo con streaming personal (Jellyfin, Navidrome, Audiobookshelf) sin depender de servicios externos
- Implementar una biblioteca de investigación académica y documental auto-alojada con IA para clasificación automática y búsqueda semántica
- Crear un entorno de desarrollo personal con Git local (Forgejo), herramientas de productividad (Miniflux, ArchiveBox) y dashboards personalizados
- Monitoreo continuo de servicios mediante Grafana Alloy + Loki + Gatus, permitiendo alertas automáticas sobre disponibilidad y rendimiento
- Gestión de contenido multimedia (series, películas, música) con automatización de sincronización entre servidores (Sonarr, Radarr, Lidarr)
- Construir un entorno de aprendizaje personal con acceso a Wikipedia offline (Kiwix), repositorios privados (Immich) y herramientas de edición de PDF
- Tecnología LXC en Proxmox permite múltiples servicios independientes sin conflictos de recursos, ideal para homelabs con 36+ servicios
- Grafana Alloy + Loki proporciona observabilidad completa: logs centralizados, métricas y dashboards unificados desde una sola interfaz
- Tailscale VPN elimina la necesidad de portas SSH abiertas en internet, garantizando que solo el equipo interno acceda a los servicios
- Ansible con Vault permite despliegue consistente y reproducible sin dependencias externas o scripts manuales
- Proxmox ofrece snapshots granulares y migraciones entre nodos desde la interfaz web, facilitando recuperación ante fallos
- No incluye herramientas de autenticación centralizada (OAuth, SSO) ni gestión de sesiones, requiriendo credenciales manuales por servicio
- La arquitectura basada en LXC puede generar muchos contenedores y consumir recursos del host Proxmox si no se optimiza el tamaño de imagen
- Tailscale requiere configuración manual adicional (SSH + ACLs) además de la VPN estándar, lo que añade complejidad operativa
- No incluye herramientas de CI/CD ni automatización de despliegue continua, requiriendo mantenimiento manual de imágenes Docker
- La dependencia de Tailscale como único método de acceso limita la escalabilidad horizontal y la interoperabilidad con infraestructuras externas
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.
Instala Proxmox en un servidor físico o virtual. En cada nodo LXC, instala Tailscale vía Playbook (SSH configurado). Ejecuta `just setup` para instalar dependencias de Ansible. Usa `ansible-playbook playbooks/immich/main.yml -i inventory --vault-password-file .vault_pass` para desplegar servicios. Para producción, considera migrar a Kubernetes con Helm charts o Docker Swarm para escalar horizontalmente y mejorar la resiliencia.
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.