Homarr — Customizable Self-Hosted Server Dashboard

Introduction

Homarr is a modern, feature-rich dashboard designed for self-hosters who want a single page to access and monitor all their services. It goes beyond simple bookmark pages by providing deep integrations with popular self-hosted applications, showing real-time data from media servers, download clients, and system monitors.

What Homarr Does

• Displays a customizable grid of application tiles with icons, status indicators, and deep links
• Integrates with Radarr, Sonarr, Lidarr, SABnzbd, qBittorrent, and other media management tools
• Shows real-time system resource usage including CPU, memory, disk, and network statistics
• Manages Docker containers directly from the dashboard with start, stop, and restart controls
• Supports multi-user access with per-user board configurations and role-based permissions

Architecture Overview

Homarr is built with Next.js and TypeScript, using tRPC for type-safe API communication between the frontend and backend. Data is stored in a SQLite database via Drizzle ORM. Service integrations poll external APIs on configurable intervals and display results in React-based widget components. Docker management communicates through the Docker socket mounted into the container.

Self-Hosting & Configuration

• Deploy via Docker with a single container, mounting the Docker socket for container management
• Add applications as tiles through the visual drag-and-drop board editor
• Configure service integrations by providing API URLs and keys in each widget's settings
• Set up multiple boards for different purposes (media, infrastructure, development)
• Enable authentication with credentials or integrate with external OAuth/OIDC providers

Key Features

• Drag-and-drop board editor with resizable widgets and responsive grid layout
• Deep integrations showing live data from 50+ self-hosted applications
• Docker container management with status monitoring and control actions
• Built-in search that queries across all configured applications and bookmarks
• Multi-board support with user-specific layouts and shared public dashboards

Comparison with Similar Tools

• Homepage — YAML-configured dashboard, simpler but less interactive editing
• Heimdall — application launcher focused on bookmarks, fewer live integrations
• Organizr — PHP-based with tab-style layout, more complex to configure
• Dashy — YAML-driven with many themes, less drag-and-drop editing capability
• Homer — static YAML dashboard, lightweight but no service integrations

FAQ

Q: Do I need to mount the Docker socket? A: Mounting the Docker socket is optional but required for container management widgets. Without it, Homarr functions as a bookmark dashboard with service integrations.

Q: Can multiple users have different dashboards? A: Yes. Homarr supports multi-user accounts where each user can have personalized board layouts while sharing access to the same service integrations.

Q: Which services does Homarr integrate with? A: Homarr integrates with media managers (Radarr, Sonarr, Lidarr), download clients (SABnzbd, qBittorrent, Deluge), DNS (Pi-hole, AdGuard Home), monitoring (Uptime Kuma), and many more.

Q: How is Homarr v1.0 different from earlier versions? A: Homarr v1.0 is a complete rewrite using Next.js, tRPC, and Drizzle ORM. It introduces multi-user support, improved widget architecture, and a new drag-and-drop editor.

Sources

• https://github.com/homarr-dev/homarr
• https://homarr.dev/docs