Skip to content
man15hPublic

About

A self-hosted dashboard for your team, family, or org — not just the admin.

Resources

Contributing

Security policy

Stars

98 stars

Watchers

1 watching

Forks

Repository files navigation

Holm

One home page for everyone in the house. You set it up once; each person signs in and gets their own start page: their apps, their bookmarks, their wallpaper.

Holm dashboard

Most self-hosted dashboards are built by one admin, for one admin. Holm is for the rest of your household, team or friends: the people who use your server but will never edit a YAML file. They sign in through your existing SSO, get walked through the apps you run, and arrange their own surface without touching anyone else's.

Why Holm

  • Multi-user from the start. Every person has their own layout, theme and bookmarks, stored server-side and synced across devices. You curate the catalog; they pick from it.
  • Uses the login you already have. OIDC with Authelia, Authentik, Keycloak, Zitadel or any provider. Give an app groups: and only those groups see it.
  • A launcher, not just a grid. Type anywhere (or ⌘K / Ctrl+K) to find apps, run commands, and search inside Immich, Paperless, Nextcloud, Jellyfin, Plex, Navidrome, Audiobookshelf, Mealie, Seerr, Planka, Karakeep, Linkwarden, Miniflux, Komga, Kavita, Papra, Thingport, Memos, Plane, GitHub, Gitea and any CalDAV calendar, each with the user's own login, plus YouTube through an Invidious server you choose.
  • Onboarding for non-technical people. Welcome slides and per-app setup guides with App Store / Play links.
  • One YAML file. No admin UI to keep in sync. Apps, branding and most settings reload on save; OIDC, database and key settings need a restart.
  • Small and private. A single container (amd64 / arm64) with built-in SQLite, so there's no separate database to run. No telemetry. A few features reach public services; what leaves the box lists them.

Holm on a phone Configure: theme, glass, icon style and wallpaper

Search reaches inside the apps people have connected, with their own login: one query for "summer" finds a calendar event, a film in Jellyfin, music and photos.

Launcher searching a calendar, Jellyfin, music and photos at once Mock data. The photos are CC0 from StockSnap.

Open a result for its details and play it straight from the launcher.

A film's details in the launcher, with Play on Jellyfin Mock data. The poster, album covers and titles are made up for the demo.

With Seerr connected, films and shows that aren't on the media server yet can be requested right from the results, as that person. Titles already there play in Jellyfin or Plex.

Launcher with Seerr: play what's there, request what isn't Mock data. Posters are Blender open movies from Wikimedia Commons: Spring, Sprite Fright and Cosmos Laundromat CC BY 4.0; Sintel, Big Buck Bunny and Tears of Steel CC BY 3.0, © Blender Foundation / Blender Studio.

Someone's first visit is already set up: a welcome, the apps they've been given, and a guide for each.

First visit: welcome slide, their apps, a setup guide

Try it in one command

No identity provider needed; this runs the bundled demo with login turned off:

docker run --rm -p 3000:3000 -e CONFIG_PATH=/app/config.demo.yml ghcr.io/man15h/holm:latest

Open http://localhost:3000. Everyone who reaches the port is the same "Guest", so keep it on your own machine.

Install

# docker-compose.yml
services:
  holm:
    image: ghcr.io/man15h/holm:latest
    ports:
      - "3000:3000"
    environment:
      - HOLM_SECRET_KEY=${HOLM_SECRET_KEY} # in .env: openssl rand -hex 32
    volumes:
      - ./config.yml:/app/config.yml:ro
      - holm-data:/app/data
    restart: unless-stopped

volumes:
  holm-data:
  1. Copy config.minimal.yml to config.yml, list your apps, and run docker compose up -d. It has no sign-in: everyone who opens Holm shares one Guest page, so keep it on your own network.
  2. For per-person pages and groups, add the auth: block from config.example.yml and register Holm as an OIDC client with your provider. The redirect URI is https://<your-holm-host>/auth/callback. That block reads ${OIDC_CLIENT_ID} and ${OIDC_CLIENT_SECRET}, so Holm won't start until both are set.

latest and stable follow the newest release. To upgrade only when you choose, pin a version tag such as holm:0.8.1. From 0.6.2, each release lists its image by tag and by digest (holm@sha256:…); the digest pins the exact build. alpha is built from dev for arm64 only.

Holm refuses to start, and logs why, when the config is missing or invalid, when it names an unset ${VAR}, when HOLM_SECRET_KEY is malformed, or when it can't write the data directory (needed even with the database off, unless HOLM_SECRET_KEY is set). The container runs as the node user (uid 1000). A data directory bind-mounted from a release before 0.5.0 needs chown -R 1000:1000 once.

When you want more, every option is documented in config.example.yml and docs/configuration.md.

How it compares

Homepage and Glance have no user accounts: everyone sees the page the admin wrote. Dashy and Homarr add sign-in, users and groups, and the admin decides which boards or sections each person can see. Holm flips it: you publish a catalog of apps once, and each person builds their own page from it. Nobody needs edit rights on a shared board, and there's no board per person for you to maintain. Searches inside apps use each person's own login.

What Holm deliberately leaves out: server stats, container health, uptime widgets. If you want a console for yourself, those tools do it well. Holm is the page you hand to everyone else.

Features

  • Per-user app grid, bookmarks, theme (dynamic / dark / light), glass (clear / frosted / solid) and icon style (colored / white / grayed)
  • 326 wallpapers or your own (a folder or a URL pattern, with an optional self-hosted resizer), picked or rotated daily
  • Brand tiles, Dashboard Icons and Simple Icons, custom mono icons
  • Launcher: frecency ranking, !photos-style scopes, !settings / !theme / !wall commands, instant answers for maths (12*(3+4)), unit conversions (5 km in mi, or just 72f) and time zones (3pm ist in london), /?q= and OpenSearch so it can be your browser's search engine
  • Search inside your apps with per-user encrypted credentials (supported apps)
  • Weather (Open-Meteo) and a configurable fallback search engine
  • Onboarding slides, setup guides, Markdown privacy policy
  • A "What's new" dialog after each upgrade, and a notice in Configure when a newer release is out
  • Installable PWA; on phones the search docks above the keyboard
  • Config-driven branding and fonts

Supported apps

Tiles: any app. Anything with a URL can be a tile. List it in config.yml and Holm looks up the icon by name from Dashboard Icons or Simple Icons.

Search integrations let each user search inside an app from Holm's search bar, using their own credentials:

App Search
Immich Photos
Paperless-ngx Documents
Nextcloud Files
Jellyfin Movies, shows and music (Quick Connect sign-in)
Plex Movies, shows and music (sign-in at plex.tv/link)
Navidrome Artists, albums, playlists and songs, with an optional player for songs, albums and playlists
Audiobookshelf Audiobooks and podcasts
Mealie Recipes
Seerr Movies and shows: play or request (signs in through Jellyfin or Plex)
Planka Cards, by name
Karakeep Bookmarks; under !b, tags and lists to search inside
Linkwarden Links
Calendar (CalDAV) Events, with optional reminders and upcoming events on the page
Miniflux Articles from your feeds
Komga Comics, manga and book series
Kavita Manga, comics and book series
Papra Documents, by name and content
Thingport 3D models; under !tp, collections and tags too
Memos Your own memos, opened in full with live checklists (Memos 0.26 or later)
Plane Work items, by title or ID, opened with state, assignees and description
GitHub Your repos, plus issues and PRs you're involved in (one owner's repos per token, plus public ones); under !gh, repos, issues and PRs in sections of their own
Gitea Repos, issues and PRs on your Gitea server; under !gt, in sections of their own
Invidious YouTube videos, from the Invidious server set in config.yml; no sign-in

App health is a health check built into each app tile, supporting Kener, Uptime Kuma, Gatus and Cachet, or a plain URL check; see App health.

Adding an integration is one adapter file and one import line. docs/integrations.md covers enabling, connecting, the security model and writing a new adapter.

What leaves the box

Holm has no telemetry. These features do talk to public services:

Feature Goes to From
Wallpapers wsrv.nl (resizing) and gitlab.com (the wallpaper set), unless wallpapers.path or url is set Holm's server
di: / si: / Lucide icons cdn.jsdelivr.net, cdn.simpleicons.org Holm's server, cached a day; visitors' IPs don't reach them
Seerr posters image.tmdb.org Holm's server
YouTube search (Invidious) The Invidious server in integrations.invidious.default_url, with the query; its thumbnails, which it may fetch from YouTube Holm's server, only when Invidious is enabled
Update notice api.github.com (Holm's latest release) Holm's server, at most every 6 hours; update_check: { enabled: false } turns it off
Weather api.open-meteo.com; place search geocoding-api.open-meteo.com; "use my location" names the place with nominatim.openstreetmap.org The visitor's browser, with the coordinates or the typed place
GitHub integration api.github.com, with the user's own token and the typed query Holm's server, only for users who connect GitHub
Fallback search Google by default (search.url) The visitor's browser, only when they send a query there
Custom font, icon URLs, logo Whatever URL config.yml names The visitor's browser

Turn off weather, point wallpapers.path at a local folder (or turn wallpapers off), use di: / si: icons or local files, and point search.url at your own engine to keep everything in-house.

Development

git clone https://github.com/man15h/holm.git
cd holm
npm install
CONFIG_PATH=config.demo.yml npm run dev
npm test        # unit tests (node:test)

Built with SvelteKit, Tailwind CSS, sql.js, openid-client, simple-icons, js-yaml, marked and DOMPurify. docs/design-system.md and docs/vision.md describe where the UI and the product are heading; both are targets, not descriptions of today's build.

License

MIT

About

A self-hosted dashboard for your team, family, or org — not just the admin.

Resources

Contributing

Security policy

Stars

98 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages