whatisgithub

What is homarr?

homarr-labs/homarr — explained in plain English

Analysis updated 2026-05-18

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

In one sentence

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

What do people build with it?

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

What is it built with?

TypeScriptDockerRedisWebSocketstRPCHelm

How does it compare?

homarr-labs/homarrklinecharts/klinechartcodebdy/rxdrag
Stars3,7633,7633,760
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderateeasymoderate
Complexity3/52/53/5
Audienceops devopsdevelopervibe coder

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

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

So what is it?

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?

Frequently asked questions

What is homarr?

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.

What language is homarr written in?

Mainly TypeScript. The stack also includes TypeScript, Docker, Redis.

How hard is homarr to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is homarr for?

Mainly ops devops.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.