Skip to content

Homelab Intelligence: A Read-Only Record of My Homelab

By Bikram Bhujel

Homelab project · November 2026

Homelab Intelligence: Knowing What Runs, Where, and What Changed

A self-hosted platform that keeps a record of what runs in my homelab, where it runs, how it connects, what changed and what needs attention. It is read-only by design, so it cannot change the systems it watches.

StackGo · Docker · GitHub Actions
Data sourceProxmox API with a read-only account, plus a declared inventory
HostingProxmox VM, published through Cloudflare Tunnel
StatusIn production since 1 November 2026
Read-onlyCannot start, stop or change anything it monitors
MilestonesEach with a written acceptance report
1-week trialCollector ran in shadow mode before going live
01 · Why build it

A dashboard of links is not the same as knowing your lab.

Link launchers show what you remembered to add. They do not tell you what changed last week, which guest has no working backup, or what depends on what. This project keeps that record.

It is deliberately not a link launcher; for that, it recommends an existing tool.

02 · Read-only by design

A monitoring tool should not be able to break things.

It reads Proxmox with a dedicated account that can look but not change anything. A bug, or a stolen session, cannot start, stop or reconfigure a single machine.

03 · Delivery

Research first, then milestones with acceptance reports.

01
Research and proposal.

The first commit is a findings and proposal document, not code.

02
Skeleton.

Authentication, database, migrations, CI and container.

03
Collector framework and inventory.

A way to describe what should exist, separate from what is discovered.

04
Proxmox collector.

Ran in shadow mode for a week before being trusted.

05
History, findings and topology.

Change timeline, storage findings, drift, dependencies and a network map.

06
Backup diagnosis.

Backup checks with fix playbooks.

04 · Features

What it shows.

01
Change timeline

What changed, when, across the lab.

History
02
Findings and storage

Storage use and problems worth attention.

Proxmox
03
Drift and dependencies

Differences from the declared inventory, and what depends on what.

Inventory
04
Topology

A network map built from Proxmox and the declared inventory.

Map
05
Backup diagnosis

The rack view highlights a machine only when its backups are failing, with a playbook to fix it.

Recovery
The homelab runs Proxmox VE with TrueNAS storage, NetBox, Snipe-IT, Nextcloud and Pi-hole.
05 · Engineering

Checked on every change.

TestsGo tests with the race detector, go vet and staticcheck.
PipelineGitHub Actions with a container smoke test.
DeploymentDocker in a Proxmox VM, published through Cloudflare Tunnel.

Collectors for Pi-hole, TrueNAS and other systems are planned but not built yet.

Comments

Questions and corrections are welcome. I read every comment before it appears, and remove spam and promotional links.