Heimdall: Panel de aplicaciones y lanzador para servidores caseros

Heimdall
Dashboard de aplicaciones

Heimdall: Panel de aplicaciones y lanzador para servidores caseros

Organiza y accede a tus servicios autohospedados desde una interfaz centralizada y personalizable

Vídeo tutorial en YouTube

Mira el vídeo completo sobre cómo instalar y usar Heimdall: Panel de aplicaciones y lanzador para servidores caseros en el canal GENBYTE:

¿Qué es Heimdall: Panel de aplicaciones y lanzador para servidores caseros?

Heimdall es un panel de aplicaciones y lanzador desarrollado por LinuxServer.io que permite centralizar el acceso a servicios autohospedados en una única interfaz web. Está diseñado para entornos HTPC y servidores caseros, ofreciendo una página de inicio personalizable donde agregar enlaces a aplicaciones como Plex, Sonarr, Radarr, NZBGet, Sabnzbd, Emby y muchas más. El proyecto está escrito en PHP sobre el framework Laravel y utiliza una base de datos SQLite por defecto, con soporte para MySQL y PostgreSQL.

Interfaz tipo dashboard para organizar y lanzar aplicaciones autohospedadas con soporte para iconos personalizados, búsqueda y respaldo de configuración.

Características principales

Panel de aplicaciones centralizado

Agrupa enlaces a servicios como Plex, Sonarr, Radarr, NZBGet, Sabnzbd, Emby, CouchPotato, Muximux, Organizr y otros en una sola página de inicio.

Personalización de la interfaz

Permite agregar, editar y organizar aplicaciones con iconos personalizados, colores y disposición en cuadrícula.

Búsqueda integrada

Incluye funcionalidad de búsqueda para localizar rápidamente aplicaciones dentro del panel.

Respaldo y restauración

Ofrece opciones para exportar e importar la configuración del dashboard, facilitando migraciones y copias de seguridad.

Soporte multiidioma

Configurable mediante la variable APP_LOCALE en el archivo de entorno, con inglés como idioma predeterminado.

Autenticación y roles opcionales

Incluye soporte para autenticación basada en encabezados HTTP (AUTH_ROLES_ENABLE) y definición de roles de administrador.

Requisitos del sistema

  • Servidor web con PHP 8.1 o superior (requerido por Laravel 10.x)
  • Extensiones PHP: OpenSSL, PDO, Mbstring, Tokenizer, XML, Ctype, JSON, BCMath, Fileinfo
  • Base de datos: SQLite (por defecto), MySQL/MariaDB o PostgreSQL
  • Composer para gestión de dependencias PHP
  • Node.js y npm para compilar assets frontend (Vite, Bootstrap, Sass)
  • Git para clonar el repositorio

Instalación con Docker Compose

Clonar el repositorio

Descarga el código fuente desde GitHub y accede al directorio del proyecto.

git clone https://github.com/linuxserver/Heimdall.git cd Heimdall

Instalar dependencias PHP

Utiliza Composer para instalar las dependencias del backend Laravel.

composer install --no-dev --optimize-autoloader

Instalar y compilar assets frontend

Instala dependencias de Node.js y compila los assets para producción con Vite.

npm ci npm run prod

Configurar variables de entorno

Copia el archivo de ejemplo y ajusta los valores según tu entorno (APP_URL, base de datos, etc.).

cp .env.example .env # Edita .env con tu editor preferido php artisan key:generate

Ejecutar migraciones de base de datos

Crea las tablas necesarias en la base de datos configurada (SQLite por defecto).

php artisan migrate --force

Servir la aplicación

Inicia el servidor de desarrollo de Laravel o configura un servidor web (Nginx/Apache) apuntando al directorio public/.

php artisan serve --host=0.0.0.0 --port=8000

Acceder al proyecto

Acceso web

Una vez iniciado el servidor, accede a la interfaz mediante el navegador en la URL configurada en APP_URL (por defecto http://localhost:8000 si usas php artisan serve).

Primer uso

Al acceder por primera vez, se presenta el panel vacío. Utiliza la interfaz de administración para agregar aplicaciones, configurar iconos y personalizar el diseño.

Casos de uso

  • Página de inicio personalizada para servidores caseros y HTPC
  • Lanzador unificado para suites de medios (Plex, Emby, Jellyfin) y automatización (Sonarr, Radarr, Lidarr)
  • Panel de acceso rápido a clientes de descarga (NZBGet, Sabnzbd, qBittorrent, Transmission)
  • Dashboard para administradores de sistemas que gestionan múltiples servicios web internos
  • Página de aterrizaje para redes locales con enlaces a servicios internos y externos

Configuración avanzada

Configuración de base de datos externa

Modifica .env para usar MySQL o PostgreSQL en lugar de SQLite. Descomenta y completa las variables DB_CONNECTION, DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME y DB_PASSWORD.

DB_CONNECTION=mysql DB_HOST=127.0.0.1 DB_PORT=3306 DB_DATABASE=heimdall DB_USERNAME=heimdall DB_PASSWORD=secreto

Habilitar autenticación por encabezados (Reverse Proxy)

Configura AUTH_ROLES_ENABLE=true y define el encabezado que contendrá los grupos del usuario (ej. remote-groups). Requiere un proxy inverso que gestione la autenticación (Authelia, Authentik, Nginx con auth_request).

AUTH_ROLES_ENABLE=true AUTH_ROLES_HEADER="remote-groups" AUTH_ROLES_HTTP_HEADER="HTTP_REMOTE_GROUPS" AUTH_ROLES_ADMIN="admin" AUTH_ROLES_DELIMITER=","

Permitir peticiones a direcciones internas

Si necesitas que Heimdall realice consultas a URLs internas (iconos, healthchecks) desde el servidor, activa ALLOW_INTERNAL_REQUESTS=true. Por defecto está desactivado por seguridad (SSRF).

ALLOW_INTERNAL_REQUESTS=true

Endurecimiento de seguridad (CVE-2025-50578)

Define TRUSTED_PROXIES con los rangos CIDR de tus proxies inversos y TRUSTED_HOSTS con el nombre de host público para prevenir inyección de cabecera Host y redirecciones abiertas.

TRUSTED_PROXIES=192.168.0.0/16,172.16.0.0/12,10.0.0.0/8,127.0.0.1 TRUSTED_HOSTS=heimdall.example.com

Gestión y mantenimiento

Actualizar la aplicación

Obtén los últimos cambios del repositorio, actualiza dependencias y ejecuta migraciones.

git pull composer install --no-dev --optimize-autoloader npm ci npm run prod php artisan migrate --force

Limpiar cachés de Laravel

Limpia cachés de configuración, rutas y vistas tras cambios en .env o código.

php artisan config:clear php artisan route:clear php artisan view:clear php artisan cache:clear

Respaldar la base de datos SQLite

Copia el archivo de base de datos (por defecto database/app.sqlite) a una ubicación segura.

cp database/app.sqlite /ruta/backup/heimdall_$(date +%F).sqlite

Exportar configuración del panel

Utiliza la función de respaldo integrada en la interfaz de administración para exportar un archivo JSON con todas las aplicaciones, iconos y ajustes.

Stack técnico

  • PHP 8.1+
  • Laravel 10.x
  • SQLite / MySQL / PostgreSQL
  • Vite
  • Bootstrap 3 (bootstrap-sass)
  • jQuery
  • Select2
  • SortableJS
  • Huebee
  • Sass
  • ESLint
  • Prettier

Referencias oficiales

Apoya el canal GENBYTE

Sígueme en mis redes sociales

Comentarios

Entradas populares de este blog

Cómo Instalar y configurar SERVIDOR VPN WIREGUARD en MIKROTIK 🔐 #VPN #Wireguard #Mikrotik #RouterOS

Cómo instalar y configurar DSM SYNOLOGY 7.2.2 en PC | Guía completa, instalación, RAID 1, SMB

Solución al Error "No se encontró la imagen de Windows RE" en Windows 10 al ejecutar reagentc /enable