explaingit

homarr-labs/homarr

★ 3,763TypeScriptAudience · ops devopsComplexity · 3/5Setup · moderate

TLDR

Homarr is a self-hosted home server dashboard with drag-and-drop setup, 40+ service integrations, real-time widget updates, and built-in user authentication. No config files required.

Mindmap

mindmap
  root((repo))
    What it does
      Server app dashboard
      Drag-drop layout
      Real-time widgets
      User management
    Tech stack
      TypeScript
      Docker
      Redis WebSockets
      OIDC LDAP
    Use cases
      Home server overview
      Self-hosted launcher
      Status monitoring
    Audience
      Self-hosters
      Home lab users
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Create a single start page for all your self-hosted apps like Plex, Sonarr, and Pi-hole

USE CASE 2

Monitor download progress and server health from one browser tab without switching apps

USE CASE 3

Set up role-based access so different household members see different dashboard tiles

Tech stack

TypeScriptDockerRedisWebSocketstRPCHelm

Getting it running

Difficulty · moderate Time to first run · 30min

Requires Docker, initial setup is straightforward but LDAP or OIDC authentication adds configuration steps.

In plain English

Homarr is a self-hosted dashboard for home servers and personal server setups. You install it on your own machine and it gives you a single browser page where you can see and access all the services running on that server, whether that is a media server, a download manager, a network tool, or anything else. The goal is to replace a collection of bookmarks with a unified, live status page. Configuration is done entirely through a drag-and-drop interface in the browser. There is no configuration file or YAML to edit by hand. You add apps, arrange them on a grid, resize tiles, and the layout is saved through the interface. The dashboard comes with over 40 integrations built in, which means it can pull real-time data from supported applications and display things like download progress, server resource usage, or upcoming calendar events directly on your tiles. Homarr includes built-in user management with support for groups, permissions, and single sign-on through OIDC and LDAP. Sensitive data is protected using BCrypt and AES-256-CBC encryption. Widgets on the dashboard update in real time through a WebSocket connection, so tiles refresh automatically without a page reload. The app ships as a Docker container and runs on x86 hardware, Raspberry Pi, old laptops, and similar consumer hardware. There is also a Helm chart available for deploying it on Kubernetes. A built-in icon picker includes over 11,000 icons for labeling your apps. Homarr suits anyone running a home server or a small self-hosted stack who wants a clean, live overview without touching config files.

Copy-paste prompts

Prompt 1
How do I install Homarr with Docker Compose and add Plex and Pi-hole as integrations?
Prompt 2
Set up Homarr with OIDC single sign-on so my household members can log in with their existing accounts
Prompt 3
How do I deploy Homarr on Kubernetes using its Helm chart with persistent storage?
Prompt 4
What integrations does Homarr support and how do I add a custom app tile with a live status widget?
Open on GitHub → Explain another repo

← homarr-labs on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.