Heimdall Application Dashboard

beginner

Application dashboard and launcher for all your web applications.

Overview

Heimdall is a visually stunning application dashboard and launcher developed by LinuxServer.io that transforms the way you access and organize your web applications. Born from the need to simplify homelab management, Heimdall provides an elegant single-page interface where you can organize all your web services, tools, and applications with customizable tiles, live statistics, and intuitive navigation. Unlike basic bookmark managers, Heimdall actively monitors your services and can display real-time data from supported applications. This Heimdall deployment creates a centralized web portal that eliminates the need to remember multiple IP addresses, ports, and URLs for your various services. The LinuxServer.io image ensures consistent updates and includes built-in support for both HTTP and HTTPS access, making it perfect for both internal homelab use and secure external access. Heimdall's enhanced app integration can pull live data from popular services like Plex, Sonarr, Radarr, and many others. Homelab enthusiasts, self-hosting advocates, and anyone managing multiple web services will find this dashboard invaluable for organizing their digital infrastructure. System administrators can deploy this for team access to internal tools, while families can use it as a central hub for media servers, home automation interfaces, and productivity applications. The tag-based organization system and custom background support make it both functional and personalized.

Key Features

Enhanced application tiles with live statistics for supported services like Plex, Nextcloud, and Sonarr
Drag-and-drop interface for organizing application tiles with custom positioning
Tag-based categorization system for grouping related applications and services
Custom background support with personal images or pre-built themes
Automatic application health monitoring with visual status indicators
Built-in search functionality across all configured applications and tags
Responsive design that adapts to desktop, tablet, and mobile screen sizes
Support for both HTTP and HTTPS access with automatic certificate handling

Common Use Cases

1Homelab dashboard for accessing Plex, Nextcloud, Pi-hole, and other self-hosted services
2Corporate intranet portal for internal tools, documentation, and employee resources
3Development team hub for accessing GitLab, Jenkins, monitoring dashboards, and documentation
4Family home automation center linking security cameras, smart home controls, and media servers
5Small business application launcher for CRM, accounting software, and productivity tools
6Educational institution portal for student and faculty access to online resources and tools
7Remote worker dashboard combining VPN access, company tools, and personal productivity apps

Prerequisites

Docker Engine 20.10+ with Docker Compose V2 support
Minimum 256MB RAM allocated for the Heimdall container
Ports 80 and 443 available on the host system (or modify port mapping)
Basic understanding of web application URLs and network connectivity
Administrative access to configure applications for enhanced statistics integration
SSL certificate files if planning to use HTTPS with custom certificates

For development & testing. Review security settings, change default credentials, and test thoroughly before production use. See Terms

docker-compose.yml

1services: 
2  heimdall: 
3    image: lscr.io/linuxserver/heimdall:latest
4    container_name: heimdall
5    environment: 
6      - PUID=1000
7      - PGID=1000
8      - TZ=UTC
9    volumes: 
10      - heimdall-config:/config
11    ports: 
12      - "80:80"
13      - "443:443"
14    networks: 
15      - heimdall-network
16    restart: unless-stopped
17
18volumes: 
19  heimdall-config: 
20
21networks: 
22  heimdall-network: 
23    driver: bridge

.env Template

.env

1# Heimdall
2# No additional configuration needed

Usage Notes

1Dashboard at http://localhost
2Add applications via UI
3Enhanced apps show live stats
4Tag-based organization
5Background customization

Quick Start

terminal

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

One-Liner

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

terminal

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

Troubleshooting

Enhanced apps not showing statistics: Verify the target application's API is accessible and authentication credentials are correct in Heimdall settings
Applications not loading after adding: Check that URLs include the correct protocol (http/https) and that target services are actually running
Custom backgrounds not displaying: Ensure image files are in supported formats (JPG, PNG) and uploaded through Heimdall's interface, not directly to filesystem
Port 80/443 already in use: Modify the ports mapping in docker-compose to use alternative ports like '8080:80' and '8443:443'
Tags not organizing properly: Recreate tags through the settings interface and reassign applications, as tag corruption can occur during imports
HTTPS certificate errors: Verify certificate files are properly mounted and readable by the container user (PUID 1000)

Community Notes

Loading notes...

Download Recipe Kit

Get all files in a ready-to-deploy package

Includes docker-compose.yml, .env template, README, and license

Components

heimdall

Related Recipes

Ad Space

Shortcuts: C CopyF FavoriteD Download