¿Cómo funciona HOMEPAGE_ALLOWED_HOSTS?

Desde la versión 0.9.0, Homepage valida la cabecera Host para prevenir Host Header Injection. Configúrelo con su dominio (p. ej. home.example.com) o en "*" para despliegues loopback accedidos mediante túnel SSH — que es el valor por defecto en ServOrbit.

¿Puede Homepage mostrar el estado de los contenedores de Docker?

Sí. Monte /var/run/docker.sock:/var/run/docker.sock:ro y añada las etiquetas homepage.group, homepage.name y homepage.href a cada contenedor que quiera mostrar. Homepage los detecta automáticamente y los añade al panel sin editar ningún archivo de configuración.

¿Dónde se almacena la configuración?

Toda la configuración vive en archivos YAML (services.yaml, widgets.yaml, bookmarks.yaml, settings.yaml) en el volumen con nombre montado en /app/config. Edítelos directamente en el VPS. Los cambios se aplican al recargar la página — no hay que reiniciar el contenedor.

¿Cuánta RAM necesita Homepage?

Menos de 128 MB para el contenedor en sí. No se requiere base de datos. Esto deja plenty de margen incluso en el plan VPS más pequeño para los servicios que está monitorizando.

Supervisar las infraestructuras.

Homepage

Dashboard autoalojado que centraliza sus servicios, widgets y favoritos en una sola página — sin base de datos, menos de 128 MB de RAM.

512 MB RAM 1 vCPU Puerto 3000 Disponible

Stack técnico

DockerNext.js

RAM mínima512 MB

CPU mínima1 vCPU

Puerto por defecto3000

SO compatiblesDistribuciones Linux a elegir

Homepage (~22 k estrellas en GitHub, Apache 2.0, Next.js) es un panel de control autoalojado que centraliza todos sus servicios, marcadores y widgets en una sola página, impecablemente organizada. Toda su configuración vive en archivos YAML — servicios, marcadores, widgets y ajustes — lo que le da una configuración compatible con GitOps que puede reconstruir idénticamente desde el código fuente en segundos.

Desarrollado en un VPS de ServOrbit, Homepage corre en un único contenedor Docker con menos de 128 MB de RAM sin ninguna base de datos. Monte el socket de Docker en modo solo lectura y Homepage descubre sus contenedores en ejecución automáticamente a través de sus etiquetas, actualizando el panel sin ninguna edición manual. Más de 100 integraciones de widgets — estadísticas de CPU y RAM, Proxmox, Plex, Grafana, Pi-hole, Sonarr, Radarr y más — muestran métricas en vivo directamente en la página.

Todos los datos permanecen en su máquina. Sin cuentas externas, sin analíticas, sin llamadas de terceros para el servicio principal. El frontend estático de Next.js carga rápido en cualquier conexión; detrás de un proxy inverso con HTTPS se convierte en su página de inicio privada, siempre disponible, para todo lo que corre en su infraestructura.

Funcionalidades clave

Configuración basada en YAML: servicios, marcadores, widgets y distribución viven en archivos de texto versionados en Git.

Descubrimiento automático: monte el socket de Docker y Homepage recoge los contenedores de sus etiquetas — sin escribir URLs a mano.

Más de 100 integraciones de widgets: estadísticas en vivo de Proxmox, Grafana, Sonarr, Pi-hole, Plex, qBittorrent y más.

Sin base de datos: un solo contenedor Next.js con menos de 128 MB de RAM — sin Postgres, sin Redis, sin migraciones.

Sin telemetría: nada que conecte al exterior — su panel permanece completamente privado.

Control total del tema: modo claro/oscuro, fondos de pantalla personalizados, paquetes de iconos y proveedores de barra de búsqueda vía settings.yaml.

Docker Compose: un comando para iniciar, un volumen con nombre para la config — reinicie sin perder distribución ni credenciales.

Iconos de estado de salud: muestre el estado activo/caído de cada servicio junto a su marcador con reglas simples de health-check.

¿Cuándo usar esta solución?

1

Centralizar una pila autoalojada

Una vez que tiene una docena de contenedores — Nextcloud, Jellyfin, Gitea, Vaultwarden — una sola homepage es mejor que escribir IPs. Defínalos en services.yaml con sus URLs y tipos de widget; el descubrimiento automático se encarga de todo contenedor con etiquetas. Todos los servicios, en una pestaña.

2

Cockpit de HomeLab con métricas en vivo

La biblioteca de widgets de Homepage obtiene datos en vivo de los servicios locales sin intermediario en la nube. Vea la carga de CPU en Proxmox, la cola de Sonarr, la tasa de bloqueo de Pi-hole y el uso del disco, juntos en una sola página. Configúrelo una vez; se actualiza en cada carga.

3

Página de marcadores compartida para un VPS de equipo

Ponga las herramientas compartidas del equipo — docs internos, monitorización, CI, revisión de código — en una instancia privada de Homepage. Los miembros abren una sola URL en lugar de buscar 'ese enlace de Grafana' en Slack. Agrupe por equipo, fije los servicios críticos y mantenga bookmarks.yaml en el repositorio.

Desplegar Homepage en su VPS

Guía optimizada para los VPS Cloud ServOrbit.

01

Pedir un VPS de ServOrbit

Homepage corre en prácticamente cualquier VPS. Un plan de 512 MB de RAM es suficiente para Homepage solo; planifique para los servicios que corren junto a él. Ubuntu 24.04 con Docker es la imagen base recomendada.

02

Desplegar desde el Marketplace

Abra su panel de ServOrbit → Marketplace → Monitorización → Homepage → Desplegar. El aprovisionador descarga ghcr.io/gethomepage/homepage:latest, crea un volumen con nombre para los archivos de configuración y arranca el contenedor en el puerto 3000 con HOMEPAGE_ALLOWED_HOSTS configurado. Espere unos 30 segundos.

03

Acceder mediante túnel SSH

Antes de añadir un dominio, acceda al panel mediante: ssh -L 3000:127.0.0.1:3000 root@<ip> y abra http://localhost:3000. Verá la página por defecto — esto confirma que el contenedor está funcionando correctamente.

04

Añadir sus servicios

Edite /opt/stacks/homepage/config/services.yaml en el VPS. Agrupe sus servicios por categoría y proporcione la URL, el slug del icono y el tipo de widget opcional para cada uno. Recargue el navegador — no se necesita reiniciar el contenedor.

05

Ponerlo detrás de HTTPS

Apunte un subdominio (p. ej. home.sudomain.com) al VPS y configure un proxy inverso. Con Caddy: home.sudomain.com { reverse_proxy localhost:3000 }. Actualice HOMEPAGE_ALLOWED_HOSTS para que coincida con el dominio y reinicie el contenedor. Su panel ya es accesible desde cualquier lugar por HTTPS.

Preguntas frecuentes

No. Homepage no tiene autenticación integrada. Está diseñado para acceso loopback o VPN. Para una URL pública, póngalo detrás de un proxy inverso que añada HTTP Basic Auth, o use Cloudflare Access delante.

Integrar el botón de despliegue

¿Mantiene un proyecto que utiliza Homepage? Este botón permite a sus lectores desplegarlo en un VPS con un clic, sin leer documentación de Docker.

Markdown

[![Deploy Homepage on ServOrbit](https://servorbit.com/brand/deploy/button.svg)](https://servorbit.com/vps-cloud?template=homepage&utm_source=deploy-badge&utm_medium=referral&utm_campaign=homepage)

HTML

<a href="https://servorbit.com/vps-cloud?template=homepage&utm_source=deploy-badge&utm_medium=referral&utm_campaign=homepage"><img src="https://servorbit.com/brand/deploy/button.svg" alt="Deploy Homepage on ServOrbit" height="40"></a>

El botón lleva al pedido de un VPS con la plantilla preseleccionada. La imagen se sirve desde servorbit.com: no tiene que alojar nada por su parte.

Soluciones complementarias

Monitorización y Observabilidad

Active Homepage en su infraestructura.

VPS Cloud dedicado: IPv4 incluida, centro de datos europeo, soporte incluido. Sus datos nunca salen de su servidor.

Configuración recomendada: 512 MB RAM · 1 vCPU