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.
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.
- 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.
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.
Mock data. The photos are CC0 from StockSnap.
Open a result for its details and play it straight from the launcher.
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.
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.
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:latestOpen http://localhost:3000. Everyone who reaches the port is the same "Guest", so keep it on your own machine.
# 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:- Copy
config.minimal.ymltoconfig.yml, list your apps, and rundocker compose up -d. It has no sign-in: everyone who opens Holm shares one Guest page, so keep it on your own network. - For per-person pages and groups, add the
auth:block fromconfig.example.ymland register Holm as an OIDC client with your provider. The redirect URI ishttps://<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.
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.
- 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/!wallcommands, instant answers for maths (12*(3+4)), unit conversions (5 km in mi, or just72f) 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
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.
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.
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.