homepage-gui
Homepage GUI es una interfaz web drag-and-drop para editar el archivo services.yaml de gethomepage.dev. Permite organizar servicios, gestionar iconos y validar YAML antes de guardar, ejecutándose en un contenedor Docker con autenticación básica.
Ficha actualizada 25 sept 2026, 0:14 · upstream 25 sept 2026, 0:06 · release v0.4.1
Qué es homepage-gui
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Homepage GUI actúa como editor visual para la configuración de gethomepage.dev, permitiendo modificar el archivo services.yaml directamente desde el navegador sin tocar código manualmente. Facilita la reordenación de secciones y servicios mediante arrastrar y soltar, así como la edición completa de campos como nombre, URL y descripción.
La herramienta opera en un único contenedor Docker detrás de una capa de autenticación opcional configurada en el primer inicio. Incluye un asistente que detecta automáticamente la ubicación del archivo de configuración en el host, validando rutas antes de permitir guardados para evitar corrupción de datos.
El software está licenciado bajo AGPL v3 y no incorpora funcionalidades de inteligencia artificial en su ejecución, aunque se utilizó como herramienta de desarrollo. Soporta validación de sintaxis YAML atómica con copias de seguridad timestamped para revertir cambios si es necesario.
- Gestión visual de servicios para dashboards autoalojados sin editar archivos manualmente
- Mantenimiento y actualización de iconos personalizados sin intervención en el sistema de archivos
- Auditoría y validación de la configuración YAML antes de aplicar cambios al dashboard
- Configuración inicial de autenticación (sign-in) para proteger el acceso al panel
- Restauración de copias de seguridad de configuraciones anteriores desde la interfaz web
- Edición atómica con respaldo timestamped antes de cada guardado para prevenir pérdida de datos
- Búsqueda automática del archivo services.yaml mediante wizard de configuración sin necesidad de rutas manuales
- Soporte para múltiples fuentes de iconos (Material, FontAwesome, Iconify) y carga local de imágenes
- Licencia AGPL v3 garantizando código fuente en despliegues de red modificados
- Validación de sintaxis YAML antes de escribir al disco para evitar errores de configuración
- Requiere acceso a internet para búsqueda de iconos y previsualizaciones, aunque la edición funciona offline
- Necesita una instalación previa de gethomepage.dev en el mismo host para funcionar correctamente
- Autenticación limitada a un único usuario administrador por defecto sin roles granulares
- Dependencia de Docker Compose v2 para la orquestación y gestión del contenedor
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
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.
Clonar repositorio, copiar .env.example y configurar HOST_CONFIG_DIR apuntando a la carpeta de config de Homepage. Ejecutar docker compose up -d. Asegurar que el contenedor de Homepage tenga acceso al directorio montado para iconos personalizados si se desea usar esa funcionalidad. Verificar permisos de escritura en la ruta configurada antes del primer guardado.
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.