Homepage 2.8.0 upgrade: new options and fixes, no breaking changes
Summary
Homepage 2.8.0 adds a few options and fixes several widget bugs. It also bumps dependencies.
New options (from the release notes):
- Quicklaunch can be disabled.
- Glances charts support min and max values.
- The Beszel widget has more optional fields.
- Deluge leech progress sorts by completion.
- BookOrbit supports API key authentication.
- The sign-in page is localized, and the HTML document now uses the page language.
Fixes (from the release notes):
- iCal timezone setting and recurring event overrides.
- Synology usernames and passwords are now URL-encoded, and DSM error handling is more generic.
- QNAP volume usage is matched by
volumeValueinstead of list position. - Pi-hole logs in again when it rejects the cached session.
bookmarksStyleis applied to bookmark groups in layout sections.- Custom API mapping labels no longer collide in i18n.
Breaking changes and deprecations
The release notes list none. We did not find any in our test either.
Tested in our lab
We upgraded a Docker Compose install from v2.7.0 to v2.8.0.
- Before: 2.7.0 started and served the page, with a bookmark we had added.
- We stopped it with
docker compose down, changed the image tag, and randocker compose up -d. - After: the container reported
healthy, the page returned HTTP 200, and our bookmark was still there.bookmarks.yamlwas unchanged. - Container logs showed no lines containing “error” or “warn”.
What we did not test: any service widget (iCal, Synology, QNAP, Pi-hole, Beszel, Deluge, Glances, BookOrbit), quicklaunch, and the sign-in page. We had no such services in the lab, so the fixes above are not verified by us.
Lab log
$ docker compose up -d
[...]
Container homepage Started
$ curl -s -o /dev/null -w "%{http_code}\n" -H "Host: 10.99.0.10:3000" localhost:3000/
200
$ docker compose down
[...]
Network hp_default Removed
$ sed -i "s/v2.7.0/v2.8.0/" compose.yaml
$ docker compose up -d
[...]
Container homepage Started
$ docker ps --format "{{.Image}} {{.Status}}"
ghcr.io/gethomepage/homepage:v2.8.0 Up 13 seconds (healthy)
$ curl -s -o /dev/null -w "%{http_code}\n" -H "Host: 10.99.0.10:3000" localhost:3000/
200
$ cat config/bookmarks.yaml
- Links:
- Example:
- href: https://example.com
$ docker logs homepage 2>&1 | grep -ci -E "error|warn"
0
Reported by others
We did not look for user reports for this release. Release notes: https://github.com/gethomepage/homepage/releases/tag/v2.8.0.
Verdict
Upgrade when convenient. The basic upgrade is clean and needs no config changes. It matters most if you use the iCal, Synology, QNAP or Pi-hole widgets, where the fixes apply. As always, keep a copy of your config folder first.
sources
other Homepage releases
- 2.7.0 upgrade now