Simple homelab portal
Go to file
Neale Pickett cbdaa90f36 Fill pane 2024-01-12 14:00:48 -07:00
cmd/portal Rename webstat to portal 2023-03-11 14:02:15 -07:00
docs Add screenshot 2023-03-11 14:01:00 -07:00
web Fill pane 2024-01-12 14:00:48 -07:00
Dockerfile Rename webstat to portal 2023-03-11 14:02:15 -07:00 license 2023-03-04 23:20:30 -07:00 Add screenshot 2023-03-11 14:01:00 -07:00 Building image 2023-03-11 13:34:31 -07:00
go.mod Initial working version 2023-03-04 23:19:54 -07:00

Homelab Portal

This repository provide some simple scaffolding to build a landing page for your homelab. You can link to all your stuff, including pretty icons, and your apps will show up under the same top URL, like they all work together somehow.

Screen Shot


You define all your services in /web/portal.json. It works like this:

        "name": "My Thing",
        "href": "",
        "icon": ""
        "name": "Another thing",
        "href": "",
        "target": "_blank"
        "name": "Stat",
        "href": "/stat.html",
        "app": "stat"

Some notes:

  • "target": "_blank" will cause clicks to open in a new tab
  • "app": "stat" makes the icon be the built-in CPU stats pie chart

Other uses for this

Since the portal stuff is all static files, you could just not use any of that, and instead use this as a service to provide CPU stats. Just open /stats.html instead of /. Or write your own ECMAScript code that imports stat.mjs.


There are lots of other things like this around. Probably the shiniest is called "Heimdall".

I made this one because I didn't want to run yet another database or a PHP server when I am perfectly happy editing a JSON file and having my browser do all the work.

Because this runs so much in the browser, no resources are used when no users are active, and when there are users, it's still very light: less than 1% CPU on my Raspberry Pi.