What is Homarr?

Homarr is a modern, customizable dashboard for your self-hosted services. It provides a single page with widgets showing the status of all your apps, quick launch links, and integrations with popular services like Sonarr, Radarr, and Overseerr. Think of it as a homepage for your homelab.

Prerequisites

Docker and Docker Compose installed (Docker Compose basics)
Self-hosted services to add to your dashboard

Docker Compose Configuration

# docker-compose.yml for Homarr
# Tested with Homarr 0.15+

services:
  homarr:
    container_name: homarr
    image: ghcr.io/ajnart/homarr:latest
    ports:
      - "7575:7575"
    volumes:
      - ./configs:/app/data/configs
      - ./icons:/app/public/icons
      - ./data:/data
      - /var/run/docker.sock:/var/run/docker.sock:ro
    restart: unless-stopped

Step-by-Step Setup

Create a directory:
Terminal window
```
mkdir ~/homarr && cd ~/homarr
```
Create the docker-compose.yml with the config above.
Start the container:
Terminal window
```
docker compose up -d
```
Access the dashboard at http://your-server-ip:7575
Add your services: Click Edit Mode, add apps with their URLs, icons, and integration settings.
Configure widgets: Add status, calendar, weather, and service-specific widgets.

Configuration Tips

Docker integration: With the Docker socket mounted, Homarr can show container status and let you start/stop containers from the dashboard.
Service integrations: Connect services like Sonarr, Radarr, Jellyfin, and others to show real-time data in widgets.
Custom icons: Upload icons to the icons folder or use Dashboard Icons.
Multiple boards: Create different dashboards for different purposes or family members.
Reverse proxy: Access your dashboard from a clean URL. See our reverse proxy guide.

Backup & Migration

Backup: The configs and data folders contain all your dashboard settings. Back them up.

Alternatives

Homepage is a config-file-based alternative with a clean design and strong service integrations. Dashy is highly customizable with a different design approach. See Homarr vs Homepage or the full Best Self-Hosted Dashboards roundup.

Verdict

Homarr is the best dashboard for self-hosters who want a visual, widget-rich experience. The Docker integration and service widgets give you a proper command center for your homelab. Set it as your browser’s homepage.