Utilities, checked 2026-09-07

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.2.0, v2.2, 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.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
`v2.1.2`	2026-08-21	No	Fixes a YAML parsing regression introduced in v2.1.1.	source for release v2.1.2
`v2.1.0`	2026-08-21	No	Reads auth providers in-process on the sign-in page and sets environment variables earlier in startup.	source for release v2.1.0
`v2.0.0`	2026-08-14	Yes	Adds Homepage's own authentication gate, changing how access to the dashboard is controlled.	source for release v2.0.0
`v1.13.2`	2026-06-09	No	Supports API changes in dispatcharr v24 and allows an explicit cookie header overwrite.	source for release v1.13.2

If it is not coming up

Read from the upstream documentation, repository and container registry by Keita Emsden on 2026-09-07. 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