# Homarr — Customizable Self-Hosted Server Dashboard

> Homarr is a sleek, modern dashboard for your self-hosted server that integrates with dozens of services. It provides real-time monitoring widgets, application shortcuts, and Docker container management in one unified interface.

## Install

Save in your project root:

# Homarr — Customizable Self-Hosted Server Dashboard

## Quick Use
```bash
docker run -d --name homarr 
  -p 7575:7575 
  -v homarr-data:/appdata 
  -v /var/run/docker.sock:/var/run/docker.sock 
  ghcr.io/homarr-dev/homarr
# Visit http://localhost:7575
```

## 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

---
Source: https://tokrepo.com/en/workflows/aee0ea24-3b87-11f1-9bc6-00163e2b0d79
Author: AI Open Source