What is it for?
Homepage is a dashboard that gathers all your self-hosted apps on one page, with their status and widgets (weather, storage, stats…).
Who is it for?
People with several apps who forget their addresses.
Good to know
Homepage only accepts the address set in HOMEPAGE_ALLOWED_HOSTS ("Host validation failed" otherwise). If you open it via IP:port, add that to the variable, separated by a comma.
After installing
- Edit the files in the config folder (services.yaml, widgets.yaml) to add your apps.
The docker-compose
Example behind Traefik. To adapt it (Nginx Proxy Manager, local port…) with a line-by-line explanation, use the generator (in French).
# docker-compose.yml : Homepage
services:
homepage:
image: ghcr.io/gethomepage/homepage:latest
container_name: homepage
restart: unless-stopped
environment:
HOMEPAGE_ALLOWED_HOSTS: accueil.mydomain.com
PUID: "1000"
PGID: "1000"
TZ: Europe/Paris
volumes:
- ./config:/app/config
networks:
- traefik
labels:
- traefik.enable=true
- traefik.http.routers.homepage.rule=Host(`accueil.mydomain.com`)
- traefik.http.routers.homepage.entrypoints=websecure
- traefik.http.routers.homepage.tls.certresolver=letsencrypt
- traefik.http.services.homepage.loadbalancer.server.port=3000
networks:
traefik:
external: true