Heimdall

Key Features

• Enhanced app integrations with live statistics for 300+ applications including Plex active streams, Sonarr download queues, and Deluge transfer rates
• Automatic application discovery and configuration suggestions for common homelab services
• Customizable dashboard themes with background image support and color scheme modifications
• Responsive grid layout that adapts to different screen sizes and device orientations
• Built-in HTTPS support with automatic certificate generation for secure access
• Search functionality across all configured applications and bookmarks
• Tag-based organization system for grouping related services and applications
• Real-time status monitoring with visual indicators for application availability

Common Use Cases

• 1Homelab dashboard for managing multiple self-hosted applications like media servers, download clients, and monitoring tools
• 2Family media center interface providing easy access to Plex, Jellyfin, and streaming services
• 3Small business internal portal for accessing company applications, documentation, and administrative tools
• 4Development environment launcher for quickly accessing local services, databases, and testing environments
• 5Network operations center (NOC) display showing status of critical infrastructure services and monitoring systems
• 6Remote access portal for safely exposing selected internal services through a single authenticated interface
• 7Educational lab environment where students need quick access to various learning platforms and tools

Prerequisites

• Docker Engine 20.10+ and Docker Compose V2 for container orchestration
• Minimum 512MB RAM allocation for the Heimdall container and web interface
• Ports 80 and 443 available on the host system for HTTP and HTTPS access
• Basic understanding of web application URLs and service endpoints for configuration
• Network access to target applications for live statistics and status monitoring
• PUID/PGID knowledge for proper file permissions in the container environment

docker-compose.yml

1services: 
2  heimdall: 
3    image: linuxserver/heimdall:latest
4    container_name: heimdall
5    restart: unless-stopped
6    environment: 
7      PUID: 1000
8      PGID: 1000
9      TZ: UTC
10    volumes: 
11      - heimdall_config:/config
12    ports: 
13      - "80:80"
14      - "443:443"
15
16volumes: 
17  heimdall_config: 

.env Template

1# No additional config needed

Usage Notes

Quick Start

1# 1. Create the compose file
2cat > docker-compose.yml << 'EOF'
3services:
4  heimdall:
5    image: linuxserver/heimdall:latest
6    container_name: heimdall
7    restart: unless-stopped
8    environment:
9      PUID: 1000
10      PGID: 1000
11      TZ: UTC
12    volumes:
13      - heimdall_config:/config
14    ports:
15      - "80:80"
16      - "443:443"
17
18volumes:
19  heimdall_config:
20EOF
21
22# 2. Create the .env file
23cat > .env << 'EOF'
24# No additional config needed
25EOF
26
27# 3. Start the services
28docker compose up -d
29
30# 4. View logs
31docker compose logs -f

One-Liner

Run this command to download and set up the recipe in one step:

1curl -fsSL https://docker.recipes/api/recipes/heimdall/run | bash

Troubleshooting