gitwtfhub

wtf is homarr?

ajnart/homarr — explained in plain English

Analysis updated 2026-06-24

7,161TypeScriptAudience · ops devopsComplexity · 2/5Setup · easy

TL;DR

Homarr is an archived self-hosted dashboard that puts all your home server apps on one customizable start page, drag-and-drop tiles connect to Plex, qBittorrent, Sonarr, Pi-hole, and dozens of other self-hosting apps.

Mindmap

mindmap
  root((Homarr))
    What it does
      Home server dashboard
      Single start page
      App status at a glance
    Integrations
      Plex and Jellyfin
      Download clients
      DNS ad-blockers
      Docker containers
    Setup
      Docker install
      No YAML config needed
      Drag and drop layout
    Status
      Archived legacy version
      Migrate to v1

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

Why would anyone build with this?

REASON 1

Build a single home page that shows live status from all your self-hosted apps like Plex, Sonarr, and Pi-hole.

REASON 2

Monitor Docker containers running on your home server directly from the Homarr dashboard.

REASON 3

Arrange and rearrange app tiles with drag-and-drop without editing any configuration files.

What's in the stack?

TypeScriptDockerReact

How it stacks up

ajnart/homarreclipse-che/chehedgedoc/hedgedoc
Stars7,1617,1647,164
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasyhardmoderate
Complexity2/54/53/5
Audienceops devopsops devopsdeveloper

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

How do you spin it up?

Difficulty · easy Time to first run · 30min

Archived, no further updates, migrate to homarr-labs/homarr for active development and new features.

Wtf does this do

Homarr is a customizable home server dashboard that provides a single start page for all the services running on a self-hosted server. Instead of opening a dozen browser tabs to check different applications, you get one page where you can see and interact with everything at once. The layout uses a drag-and-drop grid, so you can arrange tiles however you prefer without touching any configuration files. The dashboard connects directly to popular self-hosting applications. Torrent clients like Deluge, Transmission, and qBittorrent show download status. Media servers like Plex and Jellyfin surface what is playing. Media organizers like Sonarr and Radarr display upcoming downloads. DNS ad-blockers like Pi-hole and AdGuard Home are also supported. Each integration has its own documentation, and new ones are added regularly. There is also a Docker integration for monitoring containers, and a built-in icon picker with over 7,000 icons for labeling your tiles. Homarr runs on Docker, unRAID, and Synology, and works on common hardware including x86 machines, Raspberry Pis, and older laptops. A live demo is available at demo.homarr.dev if you want to explore the interface before installing. No YAML configuration files are required to set it up. This repository is archived. The project moved to homarr-labs/homarr starting with version 1.0. If you are using the old version, a migration guide is available on the project's website with instructions for upgrading. The old repository remains available for reading the code or running the legacy version, but no further updates will be made to it. Homarr is maintained by volunteer developers and welcomes community contributions through code, documentation, and translations managed through Crowdin.

Yoink these prompts

Prompt 1
I want to set up the legacy Homarr v0 dashboard on Docker. Show me a minimal docker-compose.yml to get it running and add my first tile for a Plex server.
Prompt 2
How do I connect Homarr to qBittorrent so it shows download progress on my dashboard? What settings do I need to fill in?
Prompt 3
I'm running the old Homarr and want to upgrade to version 1.0 at homarr-labs. Walk me through the migration steps described in the project's migration guide.
Prompt 4
Show me how to add a custom icon tile in Homarr for an app that does not have a built-in integration.

Frequently asked questions

wtf is homarr?

Homarr is an archived self-hosted dashboard that puts all your home server apps on one customizable start page, drag-and-drop tiles connect to Plex, qBittorrent, Sonarr, Pi-hole, and dozens of other self-hosting apps.

What language is homarr written in?

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

How hard is homarr to set up?

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

Who is homarr for?

Mainly ops devops.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.