Homarr

Dashboard for your home server with widgets for all your apps

  • ghcr.io/hsinghhira/homarr:latest
  • v2.14.0
  • Updated 21 Nov 2026
  • port 6774
  • amd64 · arm64
  • Home
  • 5.4k stars

Screenshots

Homarr screenshot 1: Board

Open the app

Dashboard

http://localhost:6774/

About Homarr

Homarr is a start page for your home server. Put all your apps on a board you arrange by drag and drop, and add widgets that show what they are doing: downloads, media, calendars, weather and system load. It connects to more than 50 apps.

Features

  • Boards you build by drag and drop, no config files
  • Widgets for downloads, media servers, calendars, weather and more
  • Integrations with Sonarr, Radarr, Jellyfin, Plex, Pi-hole, Home Assistant and many others
  • Search across your apps from one box
  • Users, groups and permissions, with OIDC and LDAP sign-in
  • Thousands of built-in app icons

How to use

  1. Open Homarr from your dashboard.
  2. Follow the onboarding: make the admin account and pick your settings.
  3. Make a board and click Edit to add apps and widgets.
  4. Add integrations in Management, then use them in widgets.

Before you install

You can install it as it is and open it at http://[ZIMAOS-IP-ADDRESS]:6774. There is no account yet: the onboarding page asks you to make the admin account. The encryption key Homarr needs is made for you on first start and kept in /DATA/AppData/homarr/appdata. OIDC, LDAP and the other settings are in the Variables tab and are added in the app settings. The Docker widgets are not set up, since they need access to the Docker socket. It is ready in about a minute.

The settings in the first table are already in the app settings. To use any other one, open the app settings, add the variable with your value, save, and the app restarts with it. A setting you leave out uses its default.

In the app settings

VariableDefault valueDescription
TZ$TZYour time zone. It is filled in from your ZimaOS time zone and used for clocks and calendars.

Server

VariableDefault valueDescription
SECRET_ENCRYPTION_KEY—The key saved passwords and API keys are encrypted with, 64 hex characters. It is made on first start and kept in /appdata/secrets.env. Only set it to move an old install.
NO_EXTERNAL_CONNECTIONfalseSet to true so Homarr never connects to the internet (no update checks, no icon downloads).
LOG_LEVELinfoHow much goes in the log: debug, info, warn or error.

Sign-in

VariableDefault valueDescription
AUTH_PROVIDERScredentialsHow people sign in, comma separated: credentials, oidc, ldap.
AUTH_SESSION_EXPIRY_TIME30dHow long people stay signed in, like 7d or 12h.
AUTH_LOGOUT_REDIRECT_URL—Where to go after signing out.

Single sign-on (OIDC)

VariableDefault valueDescription
AUTH_OIDC_ISSUER—Your provider's issuer address, like https://auth.example.com.
AUTH_OIDC_CLIENT_ID—The client ID from your provider.
AUTH_OIDC_CLIENT_SECRET—The client secret from your provider.
AUTH_OIDC_CLIENT_NAMEOIDCThe name on the sign-in button.
AUTH_OIDC_AUTO_LOGINfalseSet to true to go straight to your provider.
AUTH_OIDC_SCOPE_OVERWRITE—The scopes to ask for. Leave it out for openid, email, profile and groups.
AUTH_OIDC_GROUPS_ATTRIBUTEgroupsThe claim that holds the user's groups.

LDAP

VariableDefault valueDescription
AUTH_LDAP_URI—Your LDAP server, like ldap://ldap.example.com:389.
AUTH_LDAP_BASE—Where to look for users, like dc=example,dc=com.
AUTH_LDAP_BIND_DN—The account Homarr searches with.
AUTH_LDAP_BIND_PASSWORD—Its password.
AUTH_LDAP_SEARCH_SCOPEbasebase, one or sub.
AUTH_LDAP_USERNAME_ATTRIBUTEuidThe attribute with the user name.
AUTH_LDAP_USER_MAIL_ATTRIBUTEmailThe attribute with the email.
AUTH_LDAP_GROUP_CLASSgroupOfUniqueNamesThe object class of groups.
AUTH_LDAP_GROUP_MEMBER_ATTRIBUTEmemberThe group attribute that lists members.
docker-compose.yml
name: homarr

services:
  homarr:
    image: ghcr.io/hsinghhira/homarr:latest
    container_name: homarr
    restart: unless-stopped
    stop_grace_period: 30s
    network_mode: bridge
    environment:
      - TZ=$TZ
    ports:
      - target: 7575
        published: "6774"
        protocol: tcp
    volumes:
      - type: bind
        source: /DATA/AppData/$AppID/appdata
        target: /appdata
        bind:
          create_host_path: true
    healthcheck:
      test: ["CMD", "wget", "-q", "-O", "/dev/null", "http://127.0.0.1:7575/api/health/live"]
      interval: 30s
      timeout: 10s
      retries: 5
      start_period: 120s
    deploy:
      resources:
        limits:
          cpus: "1.00"
          memory: 1024M
        reservations:
          cpus: "0.05"
          memory: 192M
    labels:
      icon: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/homarr/icon.png
    x-casaos:
      id: com.icestore.homarr
      envs:
        - container: TZ
          description:
            en_US: >-
              Your time zone. It is filled in from your ZimaOS time zone and
              used for clocks and calendars.
      ports:
        - container: "7575"
          description:
            en_US: Homarr dashboard, published on host as 6774
      volumes:
        - container: /appdata
          description:
            en_US: >-
              Everything Homarr keeps: the SQLite database with your boards
              and integrations (db), its cache (redis), trusted
              certificates and this install's own key (secrets.env). Back
              it up.

x-casaos:
  id: com.icestore.homarr
  architectures:
    - amd64
    - arm64
  main: homarr
  author: HSinghHira
  category: Home
  developer: Homarr Labs
  icon: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/homarr/icon.png
  thumbnail: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/homarr/screenshot-1.png
  screenshot_link:
    - https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/homarr/screenshot-1.png
  title:
    en_US: Homarr
  tagline:
    en_US: Dashboard for your home server with widgets for all your apps
  description:
    en_US: >-
      Homarr is a start page for your home server. Put all your apps on a
      board you arrange by drag and drop, and add widgets that show what
      they are doing: downloads, media, calendars, weather and system load.
      It connects to more than 50 apps.


      **Features**


      - Boards you build by drag and drop, no config files

      - Widgets for downloads, media servers, calendars, weather and more

      - Integrations with Sonarr, Radarr, Jellyfin, Plex, Pi-hole, Home
        Assistant and many others

      - Search across your apps from one box

      - Users, groups and permissions, with OIDC and LDAP sign-in

      - Thousands of built-in app icons


      **How to use?**


      1. Open Homarr from the ZimaOS dashboard.

      2. Follow the onboarding: make the admin account and pick your
         settings.

      3. Make a board and click Edit to add apps and widgets.

      4. Add integrations in Management, then use them in widgets.
  tips:
    before_install:
      en_US: >-
        1. More settings, like single sign-on with OIDC or LDAP, are listed
           on the Homarr page at https://icestore.hsinghhira.me/app/homarr/
           (Variables tab). You can add them now or later in the app
           settings.


        2. Start the installation. It is ready in about a minute.


        3. Open http://[ZIMAOS-IP-ADDRESS]:6774 and follow the onboarding
           to make the admin account.
  index: /
  port_map: "6774"
  scheme: http
  is_uncontrolled: false
  version: "v2.14.0"
  update_at: "2026-11-21"
  release_notes:
    en_US: |-
      - First IceStore release, on port 6774
      - Built on ghcr.io/homarr-labs/homarr v2.14.0, with its built-in SQLite and Redis
      - Each install makes its own SECRET_ENCRYPTION_KEY on first start
  repo: "https://github.com/homarr-labs/homarr"
  support: "https://github.com/homarr-labs/homarr/issues"
  docs: "https://homarr.dev/docs/getting-started/"

Install Homarr

Something not working with Homarr?

Report it so it gets fixed, or ask for an app that is not here yet.

More Home apps

See all