Homepage 2.8.0 upgrade: new options and fixes, no breaking changes

released
lab run
upgraded from
2.7.0
guest
Ubuntu 26.04 VM
tested
yes, in our lab

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 volumeValue instead of list position.
  • Pi-hole logs in again when it rejects the cached session.
  • bookmarksStyle is 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 ran docker compose up -d.
  • After: the container reported healthy, the page returned HTTP 200, and our bookmark was still there. bookmarks.yaml was 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