homelab
Repositorio para homelab basado en UCore (Fedora CoreOS) gestionado con Ansible y Docker Compose. Incluye configuración de gateway VPS y homeserver detrás de NAT, automatizando instalación inicial, red Tailscale y despliegue de servicios.
Ficha actualizada 22 sept 2026, 17:05 · upstream 22 sept 2026, 14:32 · 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 facilita el despliegue de un homelab seguro utilizando UCore, una distribución basada en Fedora CoreOS. La arquitectura distingue entre un gateway externo (VPS) y un homeserver local detrás de NAT. El proceso de instalación inicial se automatiza mediante Butane e Ignition para configurar el sistema operativo antes del arranque.
La gestión de servicios se realiza a través de Docker Compose, permitiendo una orquestación sencilla dentro del entorno CoreOS. Ansible actúa como herramienta de gestión de configuración para aplicar playbooks que habilitan Tailscale, configuran DNS con blocky y gestionan certificados Let's Encrypt.
Las actualizaciones posteriores no requieren reinstalaciones completas; se pueden aplicar cambios a los archivos Docker o secretos mediante tags específicos en los playbooks de Ansible. El enfoque prioriza la seguridad y la automatización de tareas repetitivas en entornos domésticos.
- Automatizar instalación inicial de Fedora CoreOS con Ignition
- Gestionar servicios Docker Compose en un sistema operativo inmutable
- Configurar red privada segura mediante Tailscale sin exposición directa a internet
- Implementar gateway externo y homeserver local con roles diferenciados
- Aplicar actualizaciones parciales de configuración sin reinicio completo
- Baseado en UCore/Fedora CoreOS para un sistema operativo inmutable y seguro
- Gestión completa mediante Ansible y Docker Compose
- Integración nativa con Tailscale para acceso remoto cifrado
- Soporte para configuración de DNS bloqueante (blocky) y SSL automático
- Procedimiento simplificado para actualizaciones iterativas
- Requiere hardware compatible con Fedora CoreOS/Butane
- Necesita conocimientos previos en Ignition o Butane para la instalación inicial
- Dependencia de un VPS externo para el rol de gateway según la documentación
- No incluye scripts para backup automático de datos persistentes
- Limitado a entornos domésticos (homelab) y no producción crítica
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.
Para despliegue, ejecutar `ansible-playbook -i server.tailscale.hostname, homeserver.yml` tras validar el archivo Ignition. Asegurar que Tailscaled esté activo antes de la conexión final. Para cambios posteriores, usar `--tags deploy` en Ansible para actualizar contenedores y secretos sin tocar el sistema operativo base. Verificar compatibilidad del hardware con CoreOS.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
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.