Cómo instalar y configurar Homepage en Docker

Homepage | Docker | Dashboard | Static | Fast | Secure | Customizable | Widgets | i18n

Homepage en Docker: Dashboard de aplicaciones moderno, estático, rápido y seguro con integración Docker y más de 100 servicios 🚀📱

Homepage es un dashboard de aplicaciones moderno, completamente estático, rápido y seguro, altamente personalizable con integraciones para más de 100 servicios y traducciones a múltiples idiomas. Fácilmente configurable mediante archivos YAML o a través del descubrimiento de etiquetas de Docker.

¿Qué es Homepage en Docker?

Homepage es tu startpage ideal para el día a día y un compañero útil a lo largo del mismo, ofreciendo características como búsqueda rápida, marcadores, soporte meteorológico, una amplia gama de integraciones y widgets, un diseño elegante y moderno, y un enfoque en el rendimiento. Todo esto se ejecuta de forma estática en Docker, lo que garantiza tiempos de carga instantáneos y una alta seguridad al proxyar todas las solicitudes API.

Propuesta clave: Dashboard de aplicaciones self-hosted. Generación estática para velocidad. Seguro con proxy de API. Amplia compatibilidad (AMD64, ARM64). Soporte i18n completo. Marcadores de servicios y web. Integración Docker con descubrimiento automático de servicios por etiquetas. Más de 100 integraciones de servicios (Radarr, Sonarr, Plex, etc.). Widgets de información y utilidad (clima, hora, fecha, búsqueda). Altamente personalizable con temas y CSS/JS custom.

Para homelabs y autoalojado: Dashboard moderno, rápido y seguro. Fácil de configurar. Widgets útiles. Amplia integración.

Vídeo en YouTube

Características principales

Rápido

El sitio se genera estáticamente en tiempo de compilación para tiempos de carga instantáneos.

Seguro

Todas las solicitudes de API a servicios backend se proxyan, manteniendo tus claves API ocultas.

Multi-arquitectura

Imágenes Docker construidas para AMD64 y ARM64.

Multi-idioma (i18n)

Soporte para más de 40 idiomas.

Marcadores de servicios y web

Agrega enlaces personalizados a tu página de inicio.

Integración con Docker

Estado y estadísticas de contenedores. Descubrimiento automático de servicios vía etiquetas.

Integración de servicios

Más de 100 integraciones de servicios, incluyendo apps *arr y autoalojadas populares.

Widgets de información y utilidad

Clima, hora, fecha, búsqueda y más.

Altamente personalizable

Soporte para temas personalizados, CSS y JS, layouts y localización.

Requisitos del sistema

• Docker & Docker Compose
• PUID/PGID (opcional, para permisos de usuario/grupo)
• Puerto TCP: 3000
• Volumen para configuración: Una ruta local donde se almacenará la configuración (ej: /path/to/config).
• Volumen para Docker Socket: /var/run/docker.sock (opcional, para integración Docker).
• HOMEPAGE_ALLOWED_HOSTS: Variable de entorno requerida (ej: gethomepage.dev).

Aviso de seguridad 🔒: Homepage puede acceder a información personal. Si es accesible desde redes no confiables, DEBE estar detrás de un proxy inverso (y/o VPN) que aplique autenticación, TLS y valide estrictamente los encabezados Host. Una opción de inicio de sesión OIDC integrada o contraseña simple está disponible (opt-in) como guardia.

Configuración: Todas las configuraciones se realizan a través de archivos YAML en el volumen de configuración. Para ejemplos iniciales, copia el directorio src/skeleton a tu volumen de configuración.

Instalación con Docker Compose

Paso 1: docker-compose.yml

services: homepage: image: ghcr.io/gethomepage/homepage:latest container_name: homepage environment: - HOMEPAGE_ALLOWED_HOSTS=gethomepage.dev # Requerido, puede necesitar puerto. Ver gethomepage.dev/installation/#homepage_allowed_hosts - PUID=1000 # Opcional, tu ID de usuario - PGID=1000 # Opcional, tu ID de grupo ports: - "3000:3000" volumes: - /path/to/config:/app/config # Asegúrate de que tu directorio de configuración local exista - /var/run/docker.sock:/var/run/docker.sock:ro # Opcional, para integraciones Docker restart: unless-stopped

Paso 2: Iniciar Homepage

# Guarda el compose como docker-compose.yml en un directorio # Asegúrate de crear el directorio de configuración local primero: mkdir -p /path/to/config docker compose up -d # Espera unos segundos para que inicie docker compose logs -f homepage

Paso 3: Acceder al dashboard

# Abre en tu navegador: http://localhost:3000 # O desde otra máquina en tu red: http://<IP_DE_TU_SERVIDOR>:3000

Primeros pasos

1. Configuración inicial

1. Accede a http://localhost:3000.
2. Homepage se inicializará con una configuración básica.
3. Copia el directorio src/skeleton del repositorio de Homepage a tu volumen de configuración (/path/to/config) para obtener archivos de configuración de ejemplo.
4. Reinicia el contenedor Docker para que tome los nuevos archivos de configuración.

2. Añadir servicios y bookmarks

1. Edita los archivos YAML en tu directorio de configuración (/path/to/config).
2. Consulta la documentación de servicios y marcadores para añadir tus aplicaciones y enlaces.
3. Homepage puede descubrir automáticamente servicios Docker a través de etiquetas en tus contenedores Docker.

3. Personalizar y añadir widgets

1. Explora los archivos de configuración en /path/to/config para personalizar temas, diseños y añadir widgets.
2. La documentación de widgets te guiará para añadir clima, hora, búsquedas y más.
3. Puedes añadir CSS y JavaScript personalizados para un control total del estilo.

Gestión y mantenimiento

Ver estado

docker compose ps

Ver logs

docker compose logs -f homepage

Detener Homepage

docker compose down

Actualizar versión

docker compose pull homepage docker compose up -d homepage

Acceder shell (troubleshooting)

docker compose exec homepage bash

Backup configuración

docker cp homepage:/app/config ./homepage-config-backup

Restore configuración

docker compose down docker compose up -d docker cp ./homepage-config-backup/* homepage:/app/config/ docker compose restart homepage

Monitorear consumo

docker stats homepage

Integraciones y Widgets

Homepage tiene un amplio soporte para la integración con Docker y cientos de servicios de terceros, además de una variedad de widgets de información.

Integración Docker

• Descubrimiento automático de servicios por etiquetas en tus contenedores.
• Muestra el estado y estadísticas de tus contenedores Docker.
• Consulta la documentación de Docker Service Discovery.

Integraciones de servicios

• Más de 100 servicios soportados, incluyendo populares como Radarr, Sonarr, Lidarr, Bazarr, Ombi, Tautulli, Plex, Jellyfin, Emby, Transmission, qBittorrent, Deluge, Jackett, NZBGet, SABnzbd, etc.
• Consulta la documentación de servicios para la lista completa y configuración.

Widgets de información y utilidad

• Clima, hora, fecha, búsqueda integrada, Glances y más.
• Personaliza cómo y dónde se muestra la información en tu dashboard.
• Consulta la documentación de Information Providers.

💡 Configuración YAML: Todas las integraciones y widgets se configuran a través de archivos YAML en tu directorio /app/config. Revisa la documentación oficial para cada integración para detalles específicos.

Stack técnico

• Framework: Next.js
• Gestor de paquetes: pnpm
• Desarrollo: React (via Next.js)
• Licencia: MIT Open Source

---

Referencias oficiales

• Homepage Documentation Website
• Homepage GitHub - Repositorio oficial
• Homepage Wiki
• Docker Hub - gethomepage/homepage
• Guía de Solución de Problemas
• Discord Community

Apoya el canal GENBYTE

Suscríbete al canal de YouTube Suscríbete a la newsletter semanal Invítame a un Ko-fi genbyte@proton.me

Sígueme en mis redes sociales

Telegram Discord YouTube GitHub Blog Twitter