Homarr Application Dashboard

beginner

Homarr customizable dashboard for managing homelab services.

Overview

Homarr is a modern, customizable dashboard application designed specifically for homelab enthusiasts and self-hosted service managers. Created as an open-source alternative to commercial dashboard solutions, Homarr provides a sleek, intuitive interface for organizing and accessing all your homelab services from a single location. The application features a drag-and-drop interface builder, extensive widget support, and native Docker integration for real-time container monitoring and management. This Homarr deployment leverages Docker socket access to provide live container statistics, health monitoring, and management capabilities directly from the dashboard interface. The configuration includes persistent storage for dashboard layouts, custom icons, and application data, ensuring your carefully crafted dashboard survives container restarts and updates. The setup also enables Homarr's advanced features like service status checking, resource usage monitoring, and integrated search functionality across all configured services. Homelab administrators, self-hosting enthusiasts, and IT professionals managing multiple containerized services will find this stack invaluable for centralizing service access and monitoring. The combination of Homarr's intuitive interface with Docker socket integration creates a powerful control center that reduces the complexity of managing dozens of self-hosted applications while providing at-a-glance system health information.

Key Features

Drag-and-drop dashboard builder with customizable grid layouts and responsive design
Native Docker integration with real-time container stats, logs, and management controls
Extensive widget library including weather, calendar, RSS feeds, and system monitoring
Multiple dashboard boards support for organizing services by category or environment
Built-in service health checking with visual status indicators and uptime tracking
Custom icon support with automatic favicon fetching and local icon storage
Integrated search functionality across all configured services and applications
Theme customization with multiple color schemes and background options

Common Use Cases

1Homelab enthusiasts centralizing access to media servers, file storage, and automation tools
2Small business owners managing self-hosted productivity and collaboration services
3IT professionals organizing development, staging, and monitoring tools in one interface
4Home automation enthusiasts integrating IoT dashboards with traditional web services
5Privacy-focused users replacing cloud-based launchers with self-hosted alternatives
6Network administrators monitoring multiple services across different server locations
7Content creators managing media processing, storage, and distribution applications

Prerequisites

Docker and Docker Compose installed with minimum 512MB available RAM
Port 7575 available and not conflicting with existing homelab services
Docker socket access permissions configured for container management features
Basic understanding of web service URLs and network connectivity in homelab environment
At least 2GB free disk space for dashboard data, icons, and configuration storage

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

docker-compose.yml

1services: 
2  homarr: 
3    image: ghcr.io/ajnart/homarr:latest
4    container_name: homarr
5    volumes: 
6      - homarr_config:/app/data/configs
7      - homarr_icons:/app/public/icons
8      - homarr_data:/data
9      - /var/run/docker.sock:/var/run/docker.sock:ro
10    ports: 
11      - "7575:7575"
12    restart: unless-stopped
13    networks: 
14      - homarr-network
15
16volumes: 
17  homarr_config: 
18  homarr_icons: 
19  homarr_data: 
20
21networks: 
22  homarr-network: 
23    driver: bridge

.env Template

.env

1# Homarr
2# Configuration via web interface

Usage Notes

1Dashboard at http://localhost:7575
2Drag-and-drop interface
3Docker integration
4Widgets for various services
5Multiple board support

Quick Start

terminal

1# 1. Create the compose file
2cat > docker-compose.yml << 'EOF'
3services:
4  homarr:
5    image: ghcr.io/ajnart/homarr:latest
6    container_name: homarr
7    volumes:
8      - homarr_config:/app/data/configs
9      - homarr_icons:/app/public/icons
10      - homarr_data:/data
11      - /var/run/docker.sock:/var/run/docker.sock:ro
12    ports:
13      - "7575:7575"
14    restart: unless-stopped
15    networks:
16      - homarr-network
17
18volumes:
19  homarr_config:
20  homarr_icons:
21  homarr_data:
22
23networks:
24  homarr-network:
25    driver: bridge
26EOF
27
28# 2. Create the .env file
29cat > .env << 'EOF'
30# Homarr
31# Configuration via web interface
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/homarr-dashboard/run | bash

Troubleshooting

Dashboard shows 'Cannot connect to Docker daemon' error: Verify Docker socket mount path and container permissions for /var/run/docker.sock access
Service tiles display 'Service Unavailable' status: Check network connectivity between Homarr container and target services, ensure correct URLs and ports
Custom icons fail to load or display broken image: Verify icon files are properly uploaded to homarr_icons volume and check file permissions
Dashboard layout resets after container restart: Confirm homarr_config volume is properly mounted and has write permissions
Widgets display outdated or no data: Check API endpoints configuration and ensure external services allow requests from Homarr's IP address
Multiple boards feature not working: Update to latest Homarr image version and clear browser cache to resolve interface inconsistencies

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

homarr

Related Recipes

Ad Space

Shortcuts: C CopyF FavoriteD Download