Heimdall: Dashboard Personalizado para tu Homelab (Guía Completa 2025)

📋 TL;DR

Heimdall es un dashboard de aplicaciones self-hosted que centraliza el acceso a todos tus servicios de homelab en una única interfaz visual. En esta guía completa aprenderás a instalarlo con Docker-2025/), configurar aplicaciones (Portainer, Grafana, n8n, Pi-hole), personalizar iconos y temas, y compararlo con alternativas como Homer, Dashy y Organizr.

Lo que conseguirás:

• ✅ Dashboard centralizado con todos tus servicios organizados
• ✅ Acceso rápido sin recordar URLs o puertos
• ✅ Personalización completa (iconos, colores, categorías)
• ✅ Integración con APIs para estadísticas en tiempo real (Enhanced Apps)

Tiempo de lectura: ~15 minutos | Nivel: Principiante-Intermedio

—

📚 Tabla de Contenidos

1. ¿Qué es Heimdall y Por Qué Usarlo?
2. Comparativa: Heimdall vs Homer vs Dashy vs Organizr
3. Instalación con Docker Compose
4. Configuración Inicial y Primer Acceso
5. Añadir Aplicaciones al Dashboard
6. Personalización Avanzada: Iconos, Temas y Categorías
7. Ejemplos Prácticos: Configurar Servicios Populares
8. Enhanced Apps: Integración con APIs
9. Troubleshooting: Problemas Comunes y Soluciones
10. Mejores Prácticas y Seguridad
11. Preguntas Frecuentes
12. Conclusión y Próximos Pasos

—

> 📅 Última actualización: Diciembre 2025

> ✅ Verificado con: Heimdall v2.5.2 – Diciembre 2025

> 🔄 Próxima revisión: Marzo 2026

—

Introducción

¿Cuántas veces has tenido que recordar que Portainer está en http://192.168.1.10:9000, Grafana en https://grafana.tudominio.com, n8n en el puerto 5678, y Pi-hole en el 8080? Si gestionas un homelab con múltiples servicios, sabes lo frustrante que es tener que recordar URLs, IPs y puertos diferentes para cada herramienta.

El problema: Tienes 10, 20 o incluso 30 servicios corriendo en tu homelab, cada uno con su propia URL, puerto o dominio. No hay una forma centralizada de acceder a todos ellos, y terminas guardando bookmarks en el navegador o escribiendo URLs manualmente cada vez.

La solución: Heimdall es un dashboard de aplicaciones self-hosted que actúa como página de inicio personalizada para tu homelab. Con un solo clic accedes a Portainer, Grafana, n8n, Pi-hole, Home Assistant, o cualquier otro servicio que tengas corriendo. Todo organizado visualmente, con iconos personalizables, categorías, y hasta estadísticas en tiempo real si el servicio soporta APIs.

En esta guía completa aprenderás:

• Cómo instalar Heimdall con Docker Compose en 5 minutos
• Configurar aplicaciones Foundation (predefinidas) y Generic (personalizadas)
• Integrar Enhanced Apps con APIs para mostrar estadísticas en tiempo real
• Personalizar iconos, colores, temas y categorías
• Comparar Heimdall con alternativas (Homer, Dashy, Organizr)
• Solucionar problemas comunes y aplicar mejores prácticas de seguridad

Ya seas un principiante que acaba de montar su primer homelab o un experto con decenas de servicios, esta guía te dará todo lo necesario para crear un dashboard profesional y funcional.

—

¿Qué es Heimdall y Por Qué Usarlo? {#que-es}

Heimdall es un dashboard de aplicaciones self-hosted desarrollado por LinuxServer.io que te permite organizar y acceder a todas tus aplicaciones web y servicios desde una única interfaz visual. Está construido con PHP y Laravel, y se ejecuta como contenedor Docker, lo que lo hace extremadamente fácil de instalar y mantener.

Características Principales

• ✅ Interfaz limpia e intuitiva: Diseño moderno y fácil de usar, sin curva de aprendizaje
• ✅ Organización por categorías: Agrupa servicios relacionados (Infrastructure, Monitoring, Media, etc.)
• ✅ Iconos personalizables: Miles de iconos disponibles o sube los tuyos (SVG, PNG, WEBP)
• ✅ Temas personalizables: Ajusta colores, fondos y estilos según tus preferencias
• ✅ Enhanced Apps: Integración con APIs para mostrar estadísticas en tiempo real (Pi-hole, Plex, Sonarr, etc.)
• ✅ Bookmarks organizados: Añade enlaces rápidos organizados en grupos
• ✅ Barra de búsqueda opcional: Busca aplicaciones rápidamente
• ✅ Muy ligero: Consume menos de 100MB de RAM y mínimo CPU
• ✅ Fácil de configurar: Instalación con Docker en 5 minutos

¿Por Qué Usar Heimdall?

Casos de uso ideales:

1. Homelab con múltiples servicios: Si tienes más de 5 servicios corriendo, un dashboard centralizado ahorra tiempo y frustración
2. Acceso desde múltiples dispositivos: Comparte el dashboard con familia o compañeros de casa
3. Organización visual: Prefieres ver iconos y categorías en lugar de una lista de bookmarks
4. Estadísticas en tiempo real: Quieres ver métricas de servicios directamente en el dashboard (Enhanced Apps)

NO uses Heimdall si:

• ❌ Solo tienes 1-2 servicios (es overkill)
• ❌ Necesitas SSO o gestión de usuarios (usa Organizr)
• ❌ Quieres widgets avanzados y multi-usuario (usa Dashy)
• ❌ Prefieres configurar con YAML en lugar de interfaz web (usa Homer)

—

Comparativa: Heimdall vs Homer vs Dashy vs Organizr {#comparativa}

¿Cuándo Usar Cada Una?

Usa Heimdall si:

• ✅ Quieres algo simple, rápido y visual
• ✅ Prefieres configurar con interfaz web
• ✅ Solo necesitas acceso personal (no multi-usuario)
• ✅ Quieres Enhanced Apps básicas (APIs simples)

Usa Homer si:

• ✅ Prefieres configurar con YAML
• ✅ Quieres máxima simplicidad y ligereza
• ✅ No necesitas Enhanced Apps ni widgets
• ✅ Te sientes cómodo editando archivos de configuración

Usa Dashy si:

• ✅ Necesitas widgets avanzados y multi-usuario
• ✅ Quieres máxima customización
• ✅ Prefieres YAML pero con opciones web
• ✅ Necesitas autenticación y gestión de usuarios

Usa Organizr si:

• ✅ Necesitas SSO y gestión de usuarios avanzada
• ✅ Quieres control granular de acceso a servicios
• ✅ Tienes múltiples usuarios/familia
• ✅ Necesitas integraciones extensas con APIs

Recomendación general: Para la mayoría de usuarios de homelab personal, Heimdall es la mejor opción por su simplicidad, interfaz visual y facilidad de configuración. Si necesitas más features, Dashy es el siguiente paso lógico.

—

Instalación con Docker Compose {#instalacion}

Requisitos Previos

• ✅ Docker y Docker Compose instalados: docker --version y docker compose version
• ✅ Acceso a terminal/SSH en tu servidor
• ✅ Conocimiento básico de Docker (opcional pero recomendado)

Paso 1: Crear Directorio y Archivos

# Crear directorio para Heimdall
mkdir -p /opt/heimdall/config
cd /opt/heimdall

Paso 2: Obtener PUID y PGID

Heimdall necesita conocer tu User ID y Group ID para manejar permisos correctamente:

# Ver tu PUID y PGID
id $USER

# Output ejemplo:
# uid=1000(username) gid=1000(username) groups=1000(username),...
# PUID=1000, PGID=1000

Paso 3: Crear docker-compose.yml

Crea el archivo docker-compose.yml:

version: '3.8'

services:
  heimdall:
    image: lscr.io/linuxserver/heimdall:latest
    container_name: heimdall
    environment:
      - PUID=1000  # Reemplaza con tu PUID
      - PGID=1000  # Reemplaza con tu PGID
      - TZ=Europe/Madrid  # Reemplaza con tu timezone
    volumes:
      - ./config:/config
    ports:
      - "8080:80"
      - "8443:443"
    restart: unless-stopped

Explicación de la configuración:

• PUID/PGID: Permisos de archivos (obtenidos en Paso 2)
• TZ: Zona horaria (lista: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones)
• volumes: Persistencia de datos en ./config
• ports: Puerto 8080 para HTTP, 8443 para HTTPS (ajusta si están ocupados)

Paso 4: Iniciar Heimdall

# Iniciar contenedor
docker compose up -d

# Ver logs (opcional)
docker compose logs -f heimdall

Paso 5: Acceder al Dashboard

Abre tu navegador y accede a:

http://tu-servidor:8080

O si estás en el mismo servidor:

http://localhost:8080

¡Listo! Heimdall debería estar corriendo. En el siguiente paso configurarás la cuenta de administrador.

—

Configuración Inicial y Primer Acceso {#configuracion-inicial}

Crear Cuenta de Administrador

La primera vez que accedas a Heimdall, verás un formulario para crear la cuenta de administrador:

1. Username: Elige un nombre de usuario (ej: admin)
2. Email: Tu email (opcional pero recomendado)
3. Password: Contraseña segura (mínimo 8 caracteres recomendado)
4. Click en «Create Account»

Interfaz Principal

Una vez dentro, verás:

• Vista principal: Grid vacío donde aparecerán tus aplicaciones
• Botón «+» (arriba a la derecha): Añadir nueva aplicación o bookmark
• Icono de engranaje (abajo a la derecha): Configuración del dashboard
• Barra de búsqueda (opcional): Si está habilitada, aparece arriba

Habilitar Barra de Búsqueda (Opcional)

1. Click en el icono de engranaje (⚙️) → Settings
2. Sección «Miscellaneous»
3. Toggle «Enable Search Bar»
4. Selecciona tu proveedor de búsqueda (Google, DuckDuckGo, etc.)
5. Click «Save»

—

Añadir Aplicaciones al Dashboard {#anadir-aplicaciones}

Heimdall soporta tres tipos de aplicaciones:

Tipo 1: Generic Apps (Aplicaciones Genéricas)

Para cualquier URL que no esté en la lista de Foundation Apps:

1. Click en «+» → «Add Application»
2. Selecciona «Generic»
3. Completa:

– Name: Nombre de la aplicación (ej: «Mi API Personal»)

– URL: URL completa (ej: http://192.168.1.10:3000 o https://api.tudominio.com)

– Icon: Selecciona icono de la galería o sube uno personalizado

– Background Color: Color de fondo del tile (click para elegir)

– Category: Categoría (opcional, ej: «Development»)

1. Click «Save»

Tipo 2: Foundation Apps (Aplicaciones Predefinidas)

Para servicios populares reconocidos por Heimdall (Portainer, Grafana, n8n, etc.):

1. Click en «+» → «Add Application»
2. Empieza a escribir el nombre (ej: «Portainer»)
3. Heimdall auto-completa:

– ✅ Icono oficial del servicio

– ✅ Color de fondo sugerido

– ✅ Nombre predefinido

1. Solo necesitas proporcionar la URL
2. Click «Save»

Ventaja: Mucho más rápido que Generic Apps, y el icono/color ya están optimizados.

Tipo 3: Enhanced Apps (Aplicaciones con API)

Para servicios que soportan integración con APIs y muestran estadísticas en tiempo real:

1. Click en «+» → «Add Application»
2. Selecciona aplicación Enhanced (ej: «Pi-hole»)
3. Completa:

– URL: URL del servicio

– API Key: Clave API del servicio (ver sección Enhanced Apps)

– Additional Settings: Configuraciones específicas según el servicio

1. Click «Save»
2. El tile mostrará estadísticas en tiempo real (ej: queries bloqueadas en Pi-hole)

—

Personalización Avanzada: Iconos, Temas y Categorías {#personalizacion}

Iconos Personalizados

Formatos soportados:

• SVG (recomendado, escalable sin pérdida de calidad)
• PNG (alta resolución)
• WEBP (optimizado para web)

Subir icono personalizado:

1. Edita una aplicación existente
2. Click en «Change Icon»
3. Selecciona «Upload Custom Icon»
4. Sube tu archivo (máx. 2MB)
5. Click «Save»

Iconos oficiales disponibles:

• Dashboard Icons: https://dashboardicons.com/icons/heimdall
• Miles de iconos disponibles
• Variantes light/dark para diferentes temas
• Iconos oficiales de servicios populares

Temas y Colores

Cambiar tema:

1. Settings (⚙️) → Appearance
2. Selecciona tema predefinido o crea uno personalizado
3. Ajusta:

– Primary Color: Color principal del dashboard

– Background: Fondo (color sólido o imagen)

– Icon Style: Estilo de iconos (light/dark)

1. Click «Save»

Colores por servicio:

Para consistencia visual, usa los colores oficiales de cada servicio:

• Portainer: #00AEEF (azul)
• Grafana: #F46800 (naranja)
• n8n: #FF6D5A (rojo)
• Pi-hole: #96060B (rojo oscuro)
• Home Assistant: #41BDF5 (azul claro)

Organización por Categorías

Crear categorías:

1. Al añadir/editar aplicación, selecciona «Category»
2. Escribe nombre de categoría nueva o selecciona existente
3. Las aplicaciones se agrupan automáticamente por categoría

Categorías sugeridas:

• Infrastructure: Portainer, Docker, Proxmox, TrueNAS
• Monitoring: Grafana, Prometheus, Uptime Kuma, Loki
• Automation: n8n, Home Assistant, Node-RED
• Media: Plex, Jellyfin, Sonarr, Radarr, Prowlarr
• Security: Pi-hole, Vaultwarden, Authelia, LLDAP
• Development: Gitea, GitLab, VS Code Server
• Networking: Traefik, Nginx Proxy Manager, Caddy

—

Ejemplos Prácticos: Configurar Servicios Populares {#ejemplos-practicos}

Ejemplo 1: Configurar Portainer

Name: Portainer
Type: Foundation App
URL: http://192.168.1.10:9000
Icon: Portainer (auto-detectado)
Category: Infrastructure
Background Color: #00AEEF (azul Portainer)

Pasos:

1. Click «+» → Escribe «Portainer»
2. Auto-completa icono y color
3. Añade URL: http://tu-ip:9000
4. Categoría: «Infrastructure»
5. Save

Ejemplo 2: Configurar Grafana

Name: Grafana
Type: Foundation App
URL: https://grafana.tudominio.com
Icon: Grafana (auto-detectado)
Category: Monitoring
Background Color: #F46800 (naranja Grafana)

Si Grafana está detrás de reverse proxy:

• URL: https://grafana.tudominio.com (no IP:puerto)
• Asegúrate de que el certificado SSL sea válido

Ejemplo 3: Configurar n8n

Name: n8n
Type: Foundation App
URL: https://n8n.tudominio.com
Icon: n8n (auto-detectado)
Category: Automation
Background Color: #FF6D5A (rojo n8n)

Ejemplo 4: Configurar Pi-hole (Generic)

Si Pi-hole no aparece como Foundation App:

Name: Pi-hole
Type: Generic App
URL: http://192.168.1.10:8080/admin
Icon: Pi-hole (buscar en galería o subir)
Category: Security
Background Color: #96060B (rojo oscuro Pi-hole)

Ejemplo 5: Configurar Servicio Personalizado

Para un servicio que no está en la lista:

Name: Mi API Personal
Type: Generic App
URL: http://192.168.1.10:3000
Icon: Upload custom (sube tu logo)
Category: Development
Background Color: #4A90E2 (azul personalizado)

—

Enhanced Apps: Integración con APIs {#enhanced-apps}

Las Enhanced Apps permiten mostrar estadísticas en tiempo real directamente en el tile del dashboard. Heimdall se conecta a la API del servicio y muestra métricas actualizadas automáticamente.

Servicios Soportados (Ejemplos)

• Pi-hole: Queries bloqueadas, porcentaje bloqueado, dominios en lista negra
• Plex: Películas, series, música, espacio usado
• Sonarr/Radarr: Series/películas, descargas en cola
• NZBGet/SABnzbd: Velocidad de descarga, tamaño de cola
• Transmission/qBittorrent: Torrents activos, velocidad

Configurar Pi-hole como Enhanced App

1. Obtener API Key de Pi-hole:

1. Accede a Pi-hole Admin: http://tu-ip:8080/admin
2. Settings → API / Web interface
3. Copia el «API Token» (cadena larga)

2. Configurar en Heimdall:

1. Click «+» → Busca «Pi-hole» (Enhanced App)
2. URL: http://tu-ip:8080/admin
3. API Key: Pega el token copiado
4. Save

3. Resultado:

El tile de Pi-hole mostrará:

• Queries bloqueadas hoy
• Porcentaje de bloqueo
• Dominios en lista negra
• Actualización automática cada X minutos

Configurar Plex como Enhanced App

1. Obtener API Key de Plex:

1. Accede a Plex Web: http://tu-ip:32400/web
2. Settings → Network → Copia «Plex Token»
3. O usa: https://support.plex.tv/articles/204059436-finding-an-authentication-token-x-plex-token/

2. Configurar en Heimdall:

1. Click «+» → Busca «Plex» (Enhanced App)
2. URL: http://tu-ip:32400
3. API Key: Pega el Plex Token
4. Save

Resultado: El tile mostrará biblioteca de medios, espacio usado, etc.

Troubleshooting Enhanced Apps

Problema: No se muestran estadísticas

Soluciones:

1. Verificar API Key: Confirma que la clave es correcta y no ha expirado
2. SSL/TLS: Si el servicio usa HTTPS con certificado self-signed, Heimdall puede rechazarlo

– Solución: Usa certificados válidos (Let’s Encrypt) o habilita «Ignore SSL errors» (no recomendado)

1. Rate Limiting: Algunos servicios limitan requests API

– Reduce frecuencia de polling en configuración

– Verifica logs del servicio para errores 429

—

Troubleshooting: Problemas Comunes y Soluciones {#troubleshooting}

Problema 1: Iconos No Cargan

Síntoma: Los iconos aparecen como cuadrados vacíos o no se muestran.

Soluciones:

1. Favicon.ico no aceptado:

– Heimdall puede rechazar archivos favicon.ico

– Usa formatos PNG, JPG o SVG

– Sube icono personalizado en lugar de usar favicon

1. Iconos de Foundation Apps:

– Verifica conexión a internet (Heimdall descarga iconos)

– Actualiza Heimdall: docker compose pull && docker compose up -d

– Limpia caché del navegador (Ctrl+Shift+Delete)

Problema 2: Aplicaciones No Responden (500/404)

Síntoma: Al hacer click en una aplicación, aparece error 500 o 404.

Soluciones:

1. Verificar URL:

# Prueba la URL directamente en el navegador
   curl -I http://tu-ip:puerto

– Confirma que la URL es correcta

– Verifica que el servicio esté corriendo: docker ps

1. Problemas de red:

– Si Heimdall está en Docker, verifica red: docker network ls

– Usa IPs internas para servicios en misma red

– Verifica firewall: sudo ufw status

1. Actualizar Heimdall:

cd /opt/heimdall
   docker compose pull
   docker compose up -d

Problema 3: Permisos de Archivos

Síntoma: Errores al guardar configuraciones o subir iconos.

Soluciones:

1. Verificar PUID/PGID:

id $USER
   # Asegúrate que coinciden con docker-compose.yml

1. Corregir permisos:

sudo chown -R 1000:1000 /opt/heimdall/config

1. Reiniciar contenedor:

docker compose restart heimdall

Problema 4: Enhanced Apps No Muestran Datos

Síntoma: Las aplicaciones Enhanced (con API) no muestran estadísticas.

Soluciones:

1. Verificar API Key:

– Confirma que la API key es correcta

– Verifica que no haya expirado

– Regenera API key si es necesario

1. Problemas SSL/TLS:

– Si el servicio usa HTTPS con certificado self-signed, Heimdall puede rechazarlo

– Solución: Usa certificados válidos (Let’s Encrypt)

– O habilita «Ignore SSL errors» (no recomendado en producción)

1. Rate Limiting:

– Algunos servicios limitan requests API

– Reduce frecuencia de polling en configuración

– Verifica logs: docker compose logs heimdall

—

Mejores Prácticas y Seguridad {#mejores-practicas}

Organización

1. Usa categorías consistentes:

– Agrupa servicios relacionados

– Facilita navegación

– Ejemplos: Infrastructure, Monitoring, Media, Security

1. Nombres descriptivos:

– Usa nombres claros y consistentes

– Evita abreviaciones confusas

– Ejemplo: «Portainer – Docker» en lugar de «Port»

1. Colores consistentes:

– Usa colores oficiales de cada servicio

– Facilita identificación visual

– Ejemplo: Grafana = naranja, Portainer = azul

Seguridad

1. Reverse Proxy con SSL:

# docker-compose.advanced.yml
   labels:
     - "traefik.enable=true"
     - "traefik.http.routers.heimdall.rule=Host(`dashboard.tudominio.com`)"
     - "traefik.http.routers.heimdall.entrypoints=websecure"
     - "traefik.http.routers.heimdall.tls.certresolver=letsencrypt"

– Usa Traefik, Nginx Proxy Manager o Caddy

– SSL/TLS con Let’s Encrypt

– Acceso desde dominio en lugar de IP:puerto

1. Contraseña fuerte:

– Usa contraseña segura para cuenta admin

– Mínimo 12 caracteres, mayúsculas, números, símbolos

– Considera usar gestor de contraseñas (Vaultwarden)

1. Red interna (si es posible):

– Limita acceso a red interna

– Usa VPN (Tailscale, WireGuard) para acceso externo

– No expongas puerto 8080 directamente a internet

Backups

Backup de configuración:

#!/bin/bash
# backup-heimdall.sh
BACKUP_DIR="/backups/heimdall"
mkdir -p $BACKUP_DIR
tar -czf $BACKUP_DIR/heimdall-$(date +%Y%m%d-%H%M%S).tar.gz /opt/heimdall/config
# Mantener solo últimos 30 días
find $BACKUP_DIR -name "heimdall-*.tar.gz" -mtime +30 -delete

Automatizar con cron:

# Añadir a crontab: crontab -e
0 2 * * * /ruta/a/backup-heimdall.sh

—

Preguntas Frecuentes {#faq}

¿Qué es Heimdall?

Heimdall es un dashboard de aplicaciones self-hosted que centraliza el acceso a todos tus servicios de homelab en una única interfaz visual. Te permite organizar aplicaciones por categorías, personalizar iconos y colores, y mostrar estadísticas en tiempo real mediante integración con APIs.

¿Heimdall es realmente gratis?

Sí, Heimdall es 100% open-source y gratuito (licencia MIT). El único costo es el hosting: necesitas un servidor (VPS ~$4-5/mes o tu homelab existente). No hay límites de aplicaciones, features ocultas ni paywall.

¿Heimdall vs Homer: cuál es mejor?

Heimdall es mejor si: Prefieres configurar con interfaz web, quieres Enhanced Apps (APIs), y te gusta la simplicidad visual. Homer es mejor si: Prefieres configurar con YAML, quieres máxima ligereza, y no necesitas Enhanced Apps. Para la mayoría, Heimdall es más fácil de usar.

¿Cómo instalar Heimdall con Docker?

Tres pasos: 1) Crea carpeta y archivo docker-compose.yml con la config oficial, 2) Ajusta PUID/PGID y timezone, 3) Ejecuta docker compose up -d y accede a http://localhost:8080. El proceso completo toma 5 minutos. Ver sección «Instalación con Docker Compose» arriba.

¿Qué tipos de aplicaciones soporta Heimdall?

Soporta tres tipos: Generic Apps (cualquier URL con icono personalizado), Foundation Apps (servicios predefinidos como Portainer, Grafana, n8n con iconos auto-detectados), y Enhanced Apps (integración con APIs para estadísticas en tiempo real como Pi-hole, Plex, Sonarr).

¿Cómo configurar Enhanced Apps con APIs?

1) Obtén la API key del servicio (ej: Pi-hole Admin → Settings → API Token), 2) En Heimdall, añade aplicación Enhanced, 3) Pega la API key, 4) Guarda. El tile mostrará estadísticas en tiempo real automáticamente. Ver sección «Enhanced Apps» arriba para ejemplos detallados.

¿Puedo personalizar iconos y colores?

Sí, completamente. Puedes elegir iconos de la galería oficial (miles disponibles), subir iconos personalizados (SVG, PNG, WEBP), y personalizar colores de fondo de cada tile. También puedes cambiar temas globales en Settings → Appearance.

¿Heimdall soporta multi-usuario?

No, Heimdall no soporta multi-usuario nativo. Si necesitas gestión de usuarios, SSO o control de acceso granular, considera Dashy o Organizr como alternativas.

¿Cómo hacer backup de mi configuración?

Backup completo: tar -czf heimdall-backup.tar.gz /opt/heimdall/config. Restaurar: tar -xzf heimdall-backup.tar.gz -C /. Automatiza con cron para backups diarios. Ver sección «Mejores Prácticas» arriba para script completo.

¿Puedo usar Heimdall con reverse proxy?

Sí, absolutamente. Heimdall funciona perfectamente detrás de Traefik, Nginx Proxy Manager, Caddy o cualquier reverse proxy. Añade labels de Traefik o configura reglas en tu reverse proxy. Ver docker-compose.advanced.yml en ejemplos para configuración con Traefik.

¿Los iconos no cargan, qué hago?

1) Verifica conexión a internet (Heimdall descarga iconos), 2) Actualiza Heimdall: docker compose pull && docker compose up -d, 3) Limpia caché del navegador, 4) Si usas favicon.ico, cámbialo por PNG/SVG. Ver sección «Troubleshooting» arriba.

¿Heimdall consume muchos recursos?

No, Heimdall es extremadamente ligero: consume menos de 100MB de RAM y mínimo CPU. Es perfecto para servidores pequeños o Raspberry Pi. Comparado con Dashy u Organizr, Heimdall es el más eficiente en recursos.

¿Puedo acceder a Heimdall desde fuera de mi red?

Sí, pero NO expongas el puerto 8080 directamente a internet. Usa un reverse proxy con SSL (Traefik, Nginx Proxy Manager) o accede mediante VPN (Tailscale, WireGuard). Ver sección «Seguridad» arriba para mejores prácticas.

¿Cómo actualizar Heimdall?

cd /opt/heimdall
docker compose pull
docker compose up -d

Esto actualiza a la última versión sin perder configuración (está en ./config que persiste).

¿Heimdall vs Dashy: cuál elegir?

Heimdall: Simple, visual, fácil de configurar, ideal para uso personal. Dashy: Más features (widgets, multi-usuario, autenticación), mayor customización, ideal para dashboards avanzados. Si solo necesitas acceso rápido a servicios, Heimdall es suficiente.

—

Conclusión y Próximos Pasos {#conclusion}

Heimdall es la solución perfecta para centralizar el acceso a todos tus servicios de homelab. Con una instalación de 5 minutos, interfaz visual intuitiva y personalización completa, te ahorra tiempo y frustración al no tener que recordar URLs, IPs o puertos.

Lo que has aprendido:

• ✅ Instalar Heimdall con Docker Compose
• ✅ Configurar aplicaciones Foundation, Generic y Enhanced
• ✅ Personalizar iconos, colores, temas y categorías
• ✅ Integrar APIs para estadísticas en tiempo real
• ✅ Solucionar problemas comunes
• ✅ Aplicar mejores prácticas de seguridad

Próximos pasos:

1. Añade todos tus servicios: Portainer, Grafana, n8n, Pi-hole, etc.
2. Organiza por categorías: Infrastructure, Monitoring, Media, Security
3. Personaliza visualmente: Iconos, colores, temas
4. Configura Enhanced Apps: Pi-hole, Plex, Sonarr para estadísticas
5. Añade reverse proxy: Traefik o Nginx Proxy Manager con SSL
6. Automatiza backups: Script de backup diario con cron

Recursos adicionales:

• 📦 Descargar ejemplos: https://github.com/ziruelen/learningaiagents/tree/main/homelab/heimdall-dashboard-personalizado-homelab-guia-completa-2025
• 📖 Documentación oficial: https://heimdall.site/
• 🐳 Docker Hub: https://hub.docker.com/r/linuxserver/heimdall
• 🎨 Iconos: https://dashboardicons.com/icons/heimdall

Artículos relacionados:

• Portainer: Gestiona Docker con Interfaz Web (Guía Completa 2025)
• Prometheus + Grafana + Loki: Stack de Observabilidad Completo para Homelab
• n8n: Automatización Sin Código para Homelab
• Pi-hole: Bloquea Todos los Anuncios de tu Red con Docker (Guía Completa 2025)

¿Tienes preguntas o necesitas ayuda? Únete a nuestra comunidad en Discord ElDiarioIA o deja un comentario abajo.

—

¿Te resultó útil esta guía? Compártela con otros usuarios de homelab y ayúdanos a crecer. 🚀