Homarr o Glance: panel self-hosted para tu VPS

Por qué un panel de control self-hosted en tu VPS

Casos de uso concretos

• Página de inicio del navegador apuntando a tu propio VPS: todos tus servicios a un clic.
• Vista de estado en tiempo real de tus contenedores Docker sin abrir Portainer o Dozzle.
• Agregación de feeds RSS y noticias tech (Hacker News, Reddit, GitHub releases) en la misma pantalla que tus servicios.
• Acceso centralizado para un equipo o agencia que comparte un VPS común.
• Página de inicio de tu homelab o de tu infraestructura de desarrollo.
• Monitorización ligera sin desplegar una pila Grafana/Prometheus completa.

Homarr: panel completo con interfaz gráfica

Desplegar Homarr con Docker Compose

1. 01

   Crear el directorio y el archivo Compose

   En tu VPS, crea un directorio dedicado y un archivo docker-compose.yml:

   mkdir -p /opt/homarr && cd /opt/homarr

   Contenido del archivo docker-compose.yml:

   services:
     homarr:
       image: ghcr.io/homarr-labs/homarr:latest
       container_name: homarr
       restart: unless-stopped
       volumes:
         - /var/run/docker.sock:/var/run/docker.sock:ro
         - ./appdata:/appdata
       environment:
         - SECRET_ENCRYPTION_KEY=tu-clave-aleatoria-32-chars
       ports:
         - "7575:7575"

   SECRET_ENCRYPTION_KEY es obligatorio: Homarr cifra los secretos de sus integraciones (tokens API, contraseñas) con esta clave. Genera una con openssl rand -hex 32.

2. 02

   Generar la clave de cifrado

   Homarr requiere una clave hexadecimal de 64 caracteres:

   openssl rand -hex 32

   Copia el valor en SECRET_ENCRYPTION_KEY del archivo Compose. Sin esta variable, el contenedor se niega a arrancar.

3. 03

   Iniciar el contenedor

   docker compose up -d

   Homarr es accesible en http://your-domain.com:7575. En el primer acceso, crea tu cuenta de administrador. La configuración inicial (tiles, tema, integraciones) se realiza completamente desde la interfaz web.

4. 04

   Configurar la integración Docker

   El socket Docker (/var/run/docker.sock) está montado en solo lectura. En la interfaz de Homarr, ve a Configuración → Integraciones y añade una integración Docker apuntando a unix:///var/run/docker.sock. Homarr mostrará automáticamente el estado (running/stopped) de tus contenedores en los tiles asociados.

5. 05

   Configurar Traefik como reverse proxy

   Para exponer Homarr en HTTPS, añade estos labels a tu servicio en el archivo Compose:

   labels:
     - "traefik.enable=true"
     - "traefik.http.routers.homarr.rule=Host(`dashboard.your-domain.com`)"
     - "traefik.http.routers.homarr.entrypoints=websecure"
     - "traefik.http.routers.homarr.tls.certresolver=letsencrypt"
     - "traefik.http.services.homarr.loadbalancer.server.port=7575"

   Elimina el bloque ports si expones únicamente via Traefik.

6. 06

   Alternativa nginx

   Si usas nginx, crea un vhost /etc/nginx/sites-available/homarr.conf:

   server {
       listen 443 ssl;
       server_name dashboard.your-domain.com;
   
       ssl_certificate     /etc/letsencrypt/live/dashboard.your-domain.com/fullchain.pem;
       ssl_certificate_key /etc/letsencrypt/live/dashboard.your-domain.com/privkey.pem;
   
       location / {
           proxy_pass http://127.0.0.1:7575;
           proxy_set_header Host $host;
           proxy_set_header X-Real-IP $remote_addr;
       }
   }

   Certificado Let's Encrypt via certbot --nginx -d dashboard.your-domain.com.

Glance: un binario Go, una config YAML, sin base de datos

Desplegar Glance con Docker

1. 07

   Crear el directorio y el archivo de configuración

   mkdir -p /opt/glance && cd /opt/glance

   Crea un archivo glance.yml mínimo con un widget Hacker News y un widget Docker:

   server:
     host: 0.0.0.0
     port: 8080
   
   pages:
     - name: Inicio
       columns:
         - size: full
           widgets:
             - type: hacker-news
               title: Hacker News
   
         - size: small
           widgets:
             - type: docker-containers
               title: Contenedores
               collapsed-by-default: false

   Glance expone el puerto 8080 por defecto.

2. 08

   Lanzar con Docker Compose

   Crea un archivo docker-compose.yml:

   services:
     glance:
       image: glanceapp/glance:latest
       container_name: glance
       restart: unless-stopped
       volumes:
         - ./glance.yml:/app/glance.yml:ro
         - /var/run/docker.sock:/var/run/docker.sock:ro
       ports:
         - "8080:8080"

   Arranca con:

   docker compose up -d

   Glance es accesible en http://your-domain.com:8080.

3. 09

   Añadir un widget de tiempo

   El widget weather es uno de los más sencillos de configurar — solo requiere una ubicación:

   - type: weather
     title: Tiempo
     location: Madrid, Spain
     units: metric
     hour-format: 24h

   Añade este bloque en la sección widgets de la columna que elijas.

4. 10

   Configurar el reverse proxy para Glance

   Con Traefik, añade en tu docker-compose.yml:

   labels:
     - "traefik.enable=true"
     - "traefik.http.routers.glance.rule=Host(`glance.your-domain.com`)"
     - "traefik.http.routers.glance.entrypoints=websecure"
     - "traefik.http.routers.glance.tls.certresolver=letsencrypt"
     - "traefik.http.services.glance.loadbalancer.server.port=8080"

   Con nginx, misma estructura que Homarr, reemplazando el puerto por 8080.

5. 11

   Recarga en caliente de la configuración

   Glance monitoriza su archivo de configuración y se recarga automáticamente cuando lo modificas. No es necesario reiniciar el contenedor después de cada adición de widget — docker logs glance -f mostrará la línea Config reloaded tras unos segundos.

Homarr vs Glance: tabla comparativa

Desplace la tabla

Exponer en HTTPS con un reverse proxy

Resolución de problemas: errores comunes

¿Qué herramienta elegir?