Utilities, checked 2026-10-17

Homepage: Docker configuration reference

Self-hosted application dashboard with service widgets, bookmarks and Docker integration, configured in YAML.

At a glance

Image: ghcr.io/gethomepage/homepage
Tags: latest, v2.6.0, v2.6, v2
Licence: GPL-3.0
Source: https://github.com/gethomepage/homepage
Docs: https://gethomepage.dev/

Ports

Ports
Port	What listens	Source
`3000`	HTTP listener for the dashboard.	source for port 3000

Environment variables

Environment variables
Variable	Required	What it does	Example	Source
`HOMEPAGE_ALLOWED_HOSTS`	Yes	Comma-separated list of hosts allowed to access the app, required since v1.0 for any address other than localhost. Missing or wrong, requests are rejected and the dashboard shows a blank page.	`homepage.example.com,192.168.1.2:3000`	source for HOMEPAGE_ALLOWED_HOSTS
`PUID`	No	User ID Homepage runs as instead of the default root. Mounted volumes need matching ownership.	`1000`	source for PUID
`PGID`	No	Group ID Homepage runs as, paired with PUID.	`1000`	source for PGID

Volumes that must persist

Volumes
Path	What is in it	Source
`/app/config`	YAML configuration: services, bookmarks, widgets and settings. This is the entire application state; there is no database.	source for /app/config

Behind a reverse proxy

Route the domain to container port 3000. source for this reverse-proxy note
HOMEPAGE_ALLOWED_HOSTS must include the exact host Homepage is reached on, port included where relevant. A domain behind a reverse proxy is not covered by default; the failure mode is a blank page. source for this reverse-proxy note
Mounting the Docker socket for container integrations should go through a read-only bind mount rather than running the container as root full-time. source for this reverse-proxy note

Release timeline

Releases
Version	Date	Breaking	What changed	Source
`v2.6.0`	2026-10-17	No	Refactors the auth architecture, preserves dollar sequences in environment and file secrets and resolves a security advisory (GHSA-qxcr-4rv3-v23r).	source for release v2.6.0
`v2.5.0`	2026-10-10	No	Adds feeds, qui and Bookorbit widgets, log size limiting with rotation, and a FileFlows widget v2.	source for release v2.5.0
`v2.4.0`	2026-09-17	No	Adds bearer authentication to the whatsupdocker widget and fixes MCP variable placeholders and PeaNUT missing data.	source for release v2.4.0
`v2.3.0`	2026-09-09	No	Allows OIDC auto-login and speeds up Docker stats and container status requests with bulk calls.	source for release v2.3.0
`v2.2.0`	2026-09-02	No	Improves the Crowdsec widget and moves favicon population earlier in the load sequence.	source for release v2.2.0

If it is not coming up

Read from the upstream documentation, repository and container registry by Keita Emsden on 2026-10-17. Every row links the page it came from. Upstream changes without telling anyone, so check the source link before you rely on a value.

Other app references

All app references