$ ls ~/releases/homepage

Homepage upgrade guide

Before you upgrade Homepage, check what happened when we did. We install the previous version in a throwaway lab (Ubuntu 26.04 VM), add some data, upgrade the documented way, and record what broke and what didn't. We cover every stable release. Upstream releases: gethomepage/homepage.

latest tested2.8.0upgrade now

Clean upgrade from 2.7.0 in our lab with no config changes needed; most useful if you use the iCal, Synology, QNAP or Pi-hole widgets.

versions covered
2
lab-tested
2
last lab run
2026-11-12

all Homepage releases we tested

  1. 2.8.0Clean upgrade from 2.7.0 in our lab with no config changes needed; most useful if you use the iCal, Synology, QNAP or Pi-hole widgets.upgrade now
  2. 2.7.0Upgrade from 2.6.0 was clean in our Docker test; config and services were untouched.upgrade now