Is this meant to be configurable? I was looking for info on the Docs but searching "homepage" shows no results. When accessing the URL all that is seen is
5 replies
tomspark wrote:
You're not blind — Homepage genuinely has no edit button in the page itself. Unlike most apps it's set up by editing small text files, not in the browser, so a blank page on first launch is just the empty default. (Sorry — my earlier "pencil icon" steer was wrong; that app doesn't have one.) The config lives on your box at: /opt/sparkbox/modules/core/config/homepage/ Edit (or create) services.yaml there to add your apps, for example: - My Apps: - Jellyfin: href: http://YOUR-BOX-IP:8096 description: Media server Save it and refresh the page — Homepage picks it up instantly. Full reference: https://gethomepage.dev/configs/services/
tomspark wrote:
Homepage is configurable — you're hitting the blank-slate state on first launch. The dashboard tile should show you the setup flow, or you can edit the config directly at /opt/sparkbox/modules/core/config/homepage/ on the host. Start by clicking the Homepage tile in the SparkBox dashboard (Apps tab) — it'll show you the initial setup. If that doesn't load, SSH in and check docker logs sb-homepage --tail 50 to see if there's a startup error. Most commonly the issue is the config.json is missing or malformed — if so, docker restart sb-homepage and try the dashboard tile again. What does docker ps --format {{.Names}} show you — is sb-homepage running?
GamerX06 wrote:
Sorry, I am not sure I follow. I am not seeing any initial setup tooltip or pop up. sb-homepage is running and I'm not sure if the logs are too helpful, but here they are; \2026-05-18T05:16:12.374437301Z /app/config already owned by correct UID/GID, skipping chown n2026-05-18T05:16:12.378285917Z /app/.next already owned by correct UID/GID or running as root, skipping chown 22026-05-18T05:16:13.598864142Z ▲ Next.js 16.2.4 B2026-05-18T05:16:13.599635931Z - Local: http://[::1]:3000 A2026-05-18T05:16:13.599652554Z - Network: http://[::]:3000 02026-05-18T05:16:13.599757659Z ✓ Ready in 0ms �2026-05-18T06:32:06.575589388Z [2026-05-18T06:32:06.574Z] [32minfo[39m: 🌐 i18next is made possible by our own product, Locize — consider powering your project with managed localization (AI, CDN, integrations): https://locize.com 💙
tomspark wrote:
The blank page with no config is expected on first launch — Homepage ships with an empty state and waits for you to add services. Try clicking the pencil/edit icon in the top-right corner of the Homepage UI, or SSH in and check ls -la /opt/sparkbox/modules/core/config/homepage/ to see if config.json exists. If it's missing, docker restart sb-homepage should auto-generate a default one.
GamerX06 wrote:
"pencil/edit icon in the top-right corner of the Homepage UI" I might be blind or this is a hidden element as I am not seeing It