Por qué alojar Homepage en su VPS
Homepage (gethomepage.dev) es un dashboard estático escrito en Next.js, concebido para ser la página de inicio de su infraestructura. A diferencia de las soluciones SaaS de tipo start page, todo permanece bajo su control: la configuración vive en simples archivos YAML, los widgets consultan sus propios servicios (Proxmox, qBittorrent, Sonarr, Pi-hole…) y ningún dato pasa por una nube externa. Alojarlo en un VPS lo hace accesible desde cualquier parte y desde cualquier navegador, ya que la página se sirve casi por completo en estático. Es también el punto de entrada ideal para pilotar una stack Docker en crecimiento: un solo archivo services.yaml basta para cartografiar decenas de contenedores.
Los beneficios concretos de un Homepage autoalojado
- Configuración en YAML versionable en Git: reconstruye su dashboard idéntico en unos segundos.
- Widgets nativos para más de 100 servicios (Docker, Proxmox, Plex, Grafana, AdGuard) con estadísticas en tiempo real.
- Detección automática de los contenedores Docker mediante las etiquetas, sin escribir las URL a mano.
- Huella de memoria mínima: menos de 128 MB de RAM, ideal en un VPS pequeño.
- Sin telemetría ni dependencia de la nube: su página de inicio sigue siendo 100 % privada.
- Personalización total del tema, de los fondos de pantalla y de la barra de búsqueda.
Requisitos técnicos
Homepage es muy ligero. Un VPS con 1 vCPU y 1 GB de RAM es más que suficiente, incluso sumando otros contenedores. Cuente con unos 300 MB de espacio en disco para la imagen y la configuración. Necesitará Docker y Docker Compose (v2) instalados, un nombre de dominio o subdominio apuntando a la IP del VPS (por ejemplo home.mondomaine.com) y un reverse proxy como Traefik o Caddy para gestionar el HTTPS. Si quiere aprovechar los widgets de Docker, monte el socket /var/run/docker.sock en solo lectura.
Desplegar Homepage con Docker en 5 pasos
Preparar la estructura de carpetas
Conéctese por SSH a su VPS y cree las carpetas:
mkdir -p ~/homepage/config. Los archivosservices.yaml,widgets.yaml,settings.yamlybookmarks.yamlse generarán en esa carpeta durante el primer arranque.Escribir el docker-compose.yml
En
~/homepage/docker-compose.yml, declare el servicio con la imagenghcr.io/gethomepage/homepage:latest, monte./config:/app/configy el socket de Docker/var/run/docker.sock:/var/run/docker.sock:ro. Añada la variableHOMEPAGE_ALLOWED_HOSTS=home.mondomaine.compara autorizar su dominio.Arrancar el contenedor
Ejecute
docker compose up -dy compruebe después condocker compose logs -f. Homepage escucha por defecto en el puerto3000. Pruébelo localmente concurl http://localhost:3000.Conectar el reverse proxy y el SSL
Con Caddy basta una sola línea:
home.mondomaine.com { reverse_proxy localhost:3000 }. Caddy genera y renueva automáticamente el certificado Let's Encrypt. Con Traefik, añada las etiquetastraefik.http.routers.homepage.rule=Host(\home.mondomaine.com\)y el resolver ACME.Personalizar servicios y widgets
Edite
config/services.yamlpara agrupar sus aplicaciones y despuésconfig/widgets.yamlpara la barra de recursos (CPU, RAM, disco). Recargue la página: Homepage relee la configuración en caliente, sin reiniciar el contenedor.
Active el descubrimiento automático añadiendo las etiquetas homepage.group, homepage.name y homepage.href directamente en sus otros contenedores Docker. Homepage los detecta a través del socket montado y los añade al dashboard sin tocar services.yaml. Combinado con un archivo .env para guardar las claves de API de los widgets (nunca en claro en el YAML versionado), obtiene un dashboard que se actualiza solo con cada nuevo despliegue.
Ir más lejos: instalar Homepage desde el Marketplace de ServOrbit
Si prefiere no configurar Docker manualmente, el Marketplace de ServOrbit ofrece Homepage como instalación guiada. Unos pocos clics desde su panel de cliente aprovisionan un VPS con Homepage listo para usar — imagen oficial, puerto enlazado en loopback y HOMEPAGE_ALLOWED_HOSTS preconfigurado. Encuentre la ficha completa, los requisitos mínimos y el botón de instalación en la página dedicada del Marketplace.
