All apps · 0 apps

homarr

Overview

DESCRIPTION A sleek, modern dashboard that puts all of your apps and services at your fingertips. Control everything in one convenient location. Seamlessly integrates with the apps you've added, providing you with valuable information. Live demo: https://demo.homarr.dev NOTES • We release using semantic releases (https://semver.org/). Consult changelog before updating to major versions. The available tags to be used for this image, are: 'latest' (recommended) and 'dev'. Fixed tags (e.g. 1.2.6) are also available.

Readme

View on GitHub

Live Demo 🎮 • Install 💻 • Translations 🈺 • Discord 👋

🖌️ Highly customizable with an extensive drag and drop grid system
✨ Integrates seamlessly with your favorite self-hosted applications
📌 Easy and fast app management - no YAML involved
👤 Detailed and easy to use user management with permissions and groups
👥 Support for single sign on via OIDC / LDAP
🙊 Safe encryption using BCrypt and AES-256-CBC for your valuable data
🕔 Realtime widget updates using WebSockets, tRPC and Redis
🔍 Search through thousands of data points in supported integrations or your data in Homarr using the fast built-in search
🦞 Icon picker with over 11K icons
🚀 Compatible with any major consumer hardware (x86, Raspberry Pi, old laptops, ...) and most OS (Windows, Linux, TrueNAS, Unraid)
🖥️ Extensive Kubernetes support with Helm for efficient scaling & high reliability

AdGuard Home	Anchor	ArchiveTeam Warrior	Aria2	Audiobookshelf	Bazarr	Beszel
Coolify	Dash.	Deluge	Emby	Glances	Gluetun	Gotify
Home Assistant	iCal	Immich	Jellyfin	Jellyseerr	Lidarr	Navidrome
Nextcloud	ntfy	NZBGet	OpenMediaVault	OPNsense	Overseerr	Paperless-ngx
PatchMon	PeaNUT	Pi-hole	Plex	Prowlarr	Proxmox	qBittorrent
Radarr	Readarr	SABnzbd	Seerr	Slskd	Sonarr	Speedtest Tracker
Synology DiskStation	Tdarr	Technitium DNS	Tracearr	Traefik	Transmission	TrueNAS
Umami	Unifi Controller	Unraid	Uptime Kuma

Please click here for official installation instructions

Homarr is a free-to-use open source project maintained by volunteers and developers from all over the world. We publish under the Apache License 2.0 license which allows commercial usage. We invest multiple hours daily in providing support, developing Homarr, integrating to third party software and more. We also pay for licensing and server hosting fees. Please consider helping us cover these costs to enable the future development of Homarr. Thank you!

Please click here to sponsor us at OpenCollective

You can also support us by helping with translating the entire project to as many languages as possible or contributing directly to the code or documentation. Please read our Contribution Guidelines. All contributions, regardless of their size or scope, are welcome and highly appreciated! Thank you ❤️

Install Homarr on Unraid in a few clicks.

Find Homarr in Community Apps on your Unraid server, review the template, and click Install. Unraid handles the Docker app or plugin setup from the published template.

Open the Apps tab on your Unraid server Search Community Apps for Homarr Review the template variables and paths Click Install

Explore Unraid OS

Related apps

Explore more like this

Explore all

Utilities apps Other apps

Links

Projecthomarr.dev Supportgithub.com Registrygithub.com Templateraw.githubusercontent.com

Details

Repository

ghcr.io/homarr-labs/homarr:latest

Registry

https://github.com/homarr-labs/homarr/pkgs/container/homarr

Last Updated2026-07-17

First Seen2025-01-17

Runtime arguments

Web UI: http://[IP]:[PORT:7575]/
Network: bridge
Shell: sh
Privileged: false

Template configuration

WebUIPorttcp

Homarr is running on port 7575 inside the container. Choose the external port for the container. Access Homarr using the external port or forward requests using a reverse proxy.

Target: 7575
Value: 10004

StoragePathrw

Homarr will write application data into a database and the filesystem. This mount is required to persist data when the container is re-created.

Target: /appdata
Value: /mnt/user/appdata/homarr/appdata

Secret Encryption KeyVariable

Homarr needs API keys, usernames, passwords and other confidential data to access data in your integrations. To safely store this data, we use AES-256-CBC, which prevents third parties from extracting these credentials. For this, you must provide a randomly generated encryption key. Open a shell and copy the output of 'openssl rand -hex 32' to this field.

Target: SECRET_ENCRYPTION_KEY

Docker SocketPathro

Gives Homarr the ability to restart, stop, start, refresh and remove containers as well as add them to the dashboard. Set to read-only actions by default - can be a potential security risk.

Target: /var/run/docker.sock
Value: /var/run/docker.sock

Docker TCP HostsVariable

Alternative to mounting via path. Comma separated list of hostnames to connect to. Example: localhost,docker.example.com

Target: DOCKER_HOSTNAMES

Docker TCP Host PortsVariable

Alternative to mounting via path. Comma separated list of ports to connect to. Must be the same length as DOCKER_HOSTNAMES. Example: 2375,2376

Target: DOCKER_PORTS

Authentication: Single Sign on authentication providersVariable

Select Which provider to use between credentials, ldap and oidc. Multiple providers can be enabled with by separating them with commas (ex. 'AUTH_PROVIDERS=credentials,oidc'). It is highly recommended to just enable one provider.

Target: AUTH_PROVIDERS
Default: credentials

Authentication: Single Sign on logout redirect URLVariable

URL to redirect to after clicking logging out. Can be left empty in most cases.

Target: AUTH_LOGOUT_REDIRECT_URL

Authentication: Single Sign on session expiry timeVariable

Time for the session to time out. Can be set as pure number, which will automatically be used in seconds, or followed by s, m, h or d for seconds, minutes, hours or days. (ex: '30m')

Target: AUTH_SESSION_EXPIRY_TIME
Default: 30d
Value: 30d

Authentication: LDAP server URIVariable

URI of your LDAP server. See https://homarr.dev/docs/advanced/single-sign-on/ for more information.

Target: AUTH_LDAP_URI

Authentication: Base DN of your LDAP serverVariable

Base DN (aka. distinguished name) of your LDAP server. See https://homarr.dev/docs/advanced/single-sign-on/ for more information.

Target: AUTH_LDAP_BASE

Authentication: LDAP server bind DNVariable

User used for finding users and groups. See https://homarr.dev/docs/advanced/single-sign-on/ for more information.

Target: AUTH_LDAP_BIND_DN

Authentication: LDAP server bind passwordVariable

Password for bind user. See https://homarr.dev/docs/advanced/single-sign-on/ for more information.

Target: AUTH_LDAP_BIND_PASSWORD

Authentication: LDAP username attributeVariable

Attribute used for username. See https://homarr.dev/docs/advanced/single-sign-on/ for more information.

Target: AUTH_LDAP_USERNAME_ATTRIBUTE

Authentication: LDAP mail attributeVariable

Attribute used for mail field. See https://homarr.dev/docs/advanced/single-sign-on/ for more information.

Target: AUTH_LDAP_USER_MAIL_ATTRIBUTE

Authentication: LDAP group classVariable

Class used for querying groups. See https://homarr.dev/docs/advanced/single-sign-on/ for more information.

Target: AUTH_LDAP_GROUP_CLASS

Authentication: LDAP group member attributeVariable

Attribute used for querying group member. See https://homarr.dev/docs/advanced/single-sign-on/ for more information.

Target: AUTH_LDAP_GROUP_MEMBER_ATTRIBUTE

Authentication: LDAP group member user attributeVariable

User attribute used for comparing with group member. See https://homarr.dev/docs/advanced/single-sign-on/ for more information.

Target: AUTH_LDAP_GROUP_MEMBER_USER_ATTRIBUTE

Authentication: LDAP search scopeVariable

Search scopes between base, one and sub. See https://homarr.dev/docs/advanced/single-sign-on/ for more information.

Target: AUTH_LDAP_SEARCH_SCOPE

Authentication: LDAP username extra filter argumentsVariable

Extra arguments for user search filter (and based). See https://homarr.dev/docs/advanced/single-sign-on/ for more information.

Target: AUTH_LDAP_USERNAME_FILTER_EXTRA_ARG

Authentication: LDAP group extra filter argumentsVariable

Extra arguments for user's groups search filter (and based). See https://homarr.dev/docs/advanced/single-sign-on/ for more information.

Target: AUTH_LDAP_GROUP_FILTER_EXTRA_ARG

Authentication: OIDC issuer URIVariable

Issuer URI of OIDC provider without trailing slash (/). See https://homarr.dev/docs/advanced/single-sign-on/ for more information.

Target: AUTH_OIDC_ISSUER

Authentication: OIDC client IDVariable

ID of OIDC client (application). See https://homarr.dev/docs/advanced/single-sign-on/ for more information.

Target: AUTH_OIDC_CLIENT_ID

Authentication: OIDC client secretVariable

Secret of OIDC client (application). See https://homarr.dev/docs/advanced/single-sign-on/ for more information.

Target: AUTH_OIDC_CLIENT_SECRET

Authentication: OIDC client nameVariable

Display name of provider (in login screen). See https://homarr.dev/docs/advanced/single-sign-on/ for more information.

Target: AUTH_OIDC_CLIENT_NAME

Authentication: OIDC auto loginVariable

Automatically redirect to OIDC login. See https://homarr.dev/docs/advanced/single-sign-on/ for more information.

Target: AUTH_OIDC_AUTO_LOGIN

Authentication: OIDC scope overwriteVariable

Overwrite default scopes (openid, profile, email). See https://homarr.dev/docs/advanced/single-sign-on/ for more information.

Target: AUTH_OIDC_SCOPE_OVERWRITE

Authentication: Groups attributeVariable

Attribute used for groups (roles) claim. See https://homarr.dev/docs/advanced/single-sign-on/ for more information.

Target: AUTH_OIDC_GROUPS_ATTRIBUTE

Authentication: Name attributeVariable

Attribute used for name (preferred_username or name) claim. See https://homarr.dev/docs/advanced/single-sign-on/ for more information.

Target: AUTH_OIDC_NAME_ATTRIBUTE_OVERWRITE

Database: DriverVariable

Database driver to use. Currently better-sqlite3 is used for sqlite and mysql2 for mysql. better-sqlite3 is easier to use and requires to additional containers but may not scale as well. Default is 'better-sqlite3'.

Target: DB_DRIVER
Default: better-sqlite3|mysql2
Value: better-sqlite3

Database: DialectVariable

Database dialect to use. Either choose 'sqlite' or 'mysql'. Default is 'sqlite'

Target: DB_DIALECT
Default: sqlite|mysql
Value: sqlite

Database: URLVariable

Database URL to connect to. Default is '/appdata/db/db.sqlite'. The URL is a combination of all DB fields below. The URL will be prioritized over the other values if both are present.

Target: DB_URL

Database: HostnameVariable

Database host to connect to.

Target: DB_HOST

Database: PortVariable

Database port to connect to.

Target: DB_PORT

Database: Database NameVariable

Database name to connect to.

Target: DB_NAME

Database: UserVariable

Database user to connect with.

Target: DB_USER

Database: PasswordVariable

Database password to connect with.

Target: DB_PASSWORD

Disable automatic database migrationsVariable

Disable any automatic database migrations. Can be useful, when you manually migrate your database or if you want to restore data. Only set this to true if you know what you're doing!

Target: DB_MIGRATIONS_DISABLED
Default: false|true
Value: false

User IDVariable

By default, the container is running as root and the application is running as a lower user. Using this variable, you can override the container user - this comes at the cost of some additional complexity. See https://homarr.dev/docs/advanced/running-as-different-user/. Only set this if you know what you're doing!

Target: PUID

Group IDVariable

By default, the container is running as root and the application is running as a lower user. Using this variable, you can override the container group - this comes at the cost of some additional complexity. See https://homarr.dev/docs/advanced/running-as-different-user/. Only set this if you know what you're doing!

Target: PGID

Library

Curated

Categories