Homepage
A self-hosted application dashboard configured via YAML or Docker labels, with widgets and integrations for over 100 services.
Tested on Linux
Use it
Linux x86_64
git clone repo and install pnpm via npm
git clone --depth 1 https://github.com/gethomepage/homepage.git && npm install -g pnpmpnpm install
cd homepage && pnpm installpnpm build
cd homepage && pnpm build
Where the README and reality differ
- README: pnpm install / pnpm build
What worked: pnpm is not preinstalled; npm install -g pnpm first
Check that it works
curl -sS -f http://localhost:3000/api/healthcheckThe output should contain “up”.
First thing to try
cd homepage && mkdir -p config && cp -rn src/skeleton/* config/ && cat > config/services.yaml <<'EOF'
- Media:
- Self:
href: http://localhost:3000/
description: Homepage itself
widget:
type: customapi
url: http://localhost:3000/api/healthcheck
mappings:
- field: status
label: Status
- Sonarr:
href: http://localhost:8989/
widget:
type: sonarr
url: http://localhost:8989
key: dummy
EOF
cat > config/bookmarks.yaml <<'EOF'
- Developer:
- Github:
- abbr: GH
href: https://github.com/
EOF
cat > config/widgets.yaml <<'EOF'
- datetime:
text_size: xl
format:
timeStyle: short
- search:
provider: duckduckgo
target: _blank
- openmeteo:
label: Berlin
latitude: 52.52
longitude: 13.41
units: metric
EOFcd homepage && HOMEPAGE_ALLOWED_HOSTS=localhost:3000 pnpm startcurl -sS -f http://localhost:3000/api/healthcheckRun HOMEPAGE_ALLOWED_HOSTS=localhost:3000 pnpm start in the homepage folder, then open http://localhost:3000 in your browser.
What it does
- Add services and web bookmarksTested
How to use it
- Create the config folder with
mkdir -p config && cp -rn src/skeleton/* config/, then list your services inconfig/services.yamland your links inconfig/bookmarks.yaml. - Start the dashboard with
HOMEPAGE_ALLOWED_HOSTS=localhost:3000 pnpm start. - Check your bookmarks with
curl -sS -f http://localhost:3000/api/bookmarks.
- Create the config folder with
- Add widgets for over 100 servicesNot shown working
- Find Docker services automatically from labelsNot tested
- Show weather, time, date and search widgetsNot shown working
How far pickfit got
Linux x86_64
- Installs
- Starts
- 1 of 4 features work
- Works offline
Good for
- show status and stats of Docker containers on a dashboard
- monitor self-hosted apps like Sonarr, Radarr and Plex
- keep bookmarks on a browser start page
How pickfit tested it
Each run starts from a clean machine and follows the steps above. How pickfit verifies
Linux x86_64
Its service answers requests
- Replayed from scratch
- Works offline
- Checked on 15 Nov 2026
Differences the test machine hit
- README: HOMEPAGE_ALLOWED_HOSTS=gethomepage.dev:1234 pnpm start
In the test: Works, but next start warns it does not work with output: standalone and suggests node .next/standalone/server.js - README: copy src/skeleton to config/
In the test: pnpm build already copies missing skeleton files into config/