HomeLab/Homepage
SHA256
Watch
2
0
Fork
You've already forked Homepage
 0
generated from HomeLab/template
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
4 commits 1 branch 0 tags 16 KiB
Find a file
Exact
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Maxim Harder 723c40a6c5 fix: изменить локальные URL с https на http 
Обновить все локальные адреса домашней сети с протокола
https на http. Локальные сервисы в домашней сети не требуют
шифрования и работают по незащищённому протоколу. Это
касается Jellyfin, Paperless, Nextcloud, Homepage, Dockhand,
Dozzle, Registry UI, Registry и других локальных сервисов.
2026-09-07 13:03:11 +02:00
config fix: изменить локальные URL с https на http 2026-09-07 13:03:11 +02:00
.env.example feat: инициализировать Homepage Homelab Dashboard 2026-09-07 12:30:49 +02:00
.gitignore feat: инициализировать Homepage Homelab Dashboard 2026-09-07 12:30:49 +02:00
.woodpecker.yml Initial commit 2026-09-07 09:53:26 +02:00
docker-compose.yml feat: инициализировать Homepage Homelab Dashboard 2026-09-07 12:30:49 +02:00
README.md fix: изменить локальные URL с https на http 2026-09-07 13:03:11 +02:00

README.md

Homepage Homelab Dashboard

Dashboard for the homeserver: gethomepage.dev.

If the browser shows ERR_SSL_UNRECOGNIZED_NAME_ALERT, you opened https://home.page. Use http://home.page instead (or issue a certificate on the NPM proxy host for home.page).

Quick start

cp .env.example .env   # fill widget API keys
docker compose up -d

Config lives in config/. Docker status uses dockerproxy (not a raw docker.sock mount on Homepage). Host metrics come from the glances service; disk usage also uses bind-mounted /mnt/... paths.

Authentik on home.hrdr.dev only

Homepage has no built-in auth. Protect the external hostname in NPM; leave local open.

  1. In Authentik, create an application + Proxy Provider:
    • Mode: Forward auth (single application)
    • External host: https://home.hrdr.dev
  2. Attach the provider to an outpost (embedded or Docker outpost, same pattern as Dozzle).
  3. In Nginx Proxy Manager, for proxy host home.hrdr.dev:
    • Forward to http://homepage:3000 (already configured)
    • Enable Authentik / Forward Auth (Access List or custom locations for /outpost.goauthentik.io/ as required by your Authentik + NPM setup)
  4. For proxy host home.page:
    • Forward to the same Homepage container
    • Do not attach the Authentik Access List / Forward Auth
  5. Verify:

Widget secrets

Copy .env.example → .env and set HOMEPAGE_VAR_* values. Restart Homepage after changes:

docker compose up -d homepage

Layout notes

  • Services with both local and external NPM hosts appear as two cards (local) / (external).
  • Docker status is attached to the local card when both exist.
  • Other / Not on this host lists NPM entries missing from the last docker-ps snapshot.
  • Apps without NPM use http://192.168.178.6:<port> (or https for Portainer).