Homelab #7 Create Widgets with Gethomepage
HOMELAB

Homelab #7 Create Widgets with Gethomepage

Thất Nghiệp Thất Nghiệp
Mar 5, 2026 2 min read 0 views
Back to Blog

Recently I only focused on creating services to use. Now I have to put them on a dashboard to flex a bit. After this post I’ll probably have a basic website that’s actually viewable.

Gethomepage Widget

You need to read the gethomepage docs to do this.

Problems

Problem 1: Can’t SSH remote

While using VSC to SSH into the homelab to custom code, I found the error that caused the Portainer setup to be unreachable. Basically I set the subnet to /32, which makes it only talk to itself and the gateway, with no local network access.

Simple fix: change it to /24.

SSH remote works nicely, no need to type nano like a caveman

Problem 1: Can’t SSH remote - SSH remote works nicely, no need to type nano like a caveman

Problem 2: Not Allowed host in gethomepage

Host validation failed for: 192.168.1.201:3000. Hint: Set the HOMEPAGE_ALLOWED_HOSTS environment variable to allow requests from this host / port.

Pretty easy fix. Just change the environment allow host to match the host you want

    environment:
      HOMEPAGE_ALLOWED_HOSTS: gethomepage.dev # required, may need port. See gethomepage.dev/installation/#homepage_allowed_hosts

You have to bring docker compose down and up again. If you only restart, the network stuff doesn’t reset

Problem 2: Not Allowed host in gethomepage - environment:
      HOMEPAGE_ALLOWED_HOSTS: gethomepage

Problem 3: Browser cache

After CSS, I checked the live domain and got stuck with Cloudflare cache. Because I was accessing via the domain, I couldn’t see any changes => wasted about 30 minutes before realizing and going back to the local host

Problem 3: Browser cache - After CSS, I checked the live domain and got stuck with Cloudflare cache

Time to do CSS… later

Share this article

Thất Nghiệp

Written by Thất Nghiệp

A developer sharing thoughts on clean code, creative freedom, and the pursuit of the perfect dev environment. Building digital sanctuaries one component at a time.

Comments

Join the conversation

Leave a comment

Won't be published

You might also like