What is Homarr?
Homarr is a powerful, customizable dashboard designed specifically for managing and monitoring your self-hosted applications and services. It provides a unified interface to access all your services, monitor their status, and interact with them through seamless integrations.Homarr v1.54.0 is the latest stable release, bringing enhanced integrations, performance improvements, and a refined user experience.
Key Features
Drag & Drop Customization
Highly customizable interface with an extensive drag-and-drop grid system. Design your perfect dashboard layout without touching any configuration files.
Rich Integrations
Seamlessly integrates with 50+ popular self-hosted applications including Plex, Jellyfin, Sonarr, Radarr, Proxmox, Home Assistant, and many more.
User Management
Detailed user management system with granular permissions, groups, and support for single sign-on via OIDC and LDAP.
Real-time Updates
Real-time widget updates using WebSockets, tRPC, and Redis for instant feedback on your services’ status.
Additional Capabilities
- No Configuration Files: Easy and fast app management without editing YAML or JSON files manually
- Enterprise-grade Security: Safe encryption using BCrypt and AES-256-CBC for sensitive data
- Powerful Search: Search through thousands of data points across integrations or within Homarr itself
- Extensive Icon Library: Icon picker with over 11,000 icons to choose from
- Hardware Flexibility: Compatible with any major consumer hardware (x86, ARM/Raspberry Pi, old laptops)
- Cross-platform: Runs on Windows, Linux, TrueNAS, Unraid, and more
- Kubernetes Ready: Extensive Kubernetes support for efficient scaling and high reliability
Architecture Overview
Homarr is built on a modern technology stack designed for performance and scalability:Components
- Next.js Frontend: React-based web application built with Next.js 16 and Mantine UI components
- Nginx Reverse Proxy: Routes HTTP traffic to Next.js and WebSocket connections appropriately
- WebSocket Server: Handles real-time updates and notifications
- Background Tasks: Manages scheduled jobs, integration polling, and maintenance tasks
- Redis: In-memory cache for session management and real-time data (embedded by default)
- Database: Supports SQLite (default), MySQL, or PostgreSQL for persistent storage
System Requirements
Minimum Requirements
Memory
- Minimum: 512 MB RAM
- Recommended: 1 GB+ RAM for optimal performance with multiple integrations
Storage
- Minimum: 500 MB for application and database
- Recommended: 1 GB+ for logs and application data
Supported Platforms
- Linux: Ubuntu, Debian, Fedora, Arch, and derivatives
- Container Platforms: Docker, Podman, Kubernetes
- NAS Systems: TrueNAS, Unraid, Synology, QNAP
- ARM Devices: Raspberry Pi 3/4/5, Orange Pi, and other ARM64 devices
- Windows: Via Docker Desktop or WSL2
Database Support
Use Cases
Home Lab Management
Centralize access to all your home lab services, monitor system resources, and manage media servers from a single dashboard.Media Server Dashboard
Create a beautiful interface for your Plex, Jellyfin, or Emby server with integration for *arr applications (Sonarr, Radarr, etc.).Network Monitoring
Monitor your network infrastructure with integrations for Pi-hole, AdGuard Home, OPNsense, Proxmox, and Unifi.Team Collaboration
Share dashboards with team members using granular permissions and groups, with SSO support for enterprise environments.What’s Next?
Quick Start
Get Homarr up and running in 5 minutes with Docker
Docker Installation
Detailed Docker setup instructions
Docker Compose
Production-ready Docker Compose configuration
Kubernetes
Deploy Homarr on Kubernetes for high availability