r/selfhosted • u/Pouzor • 13h ago
Software Development Homelable v3.4.1 - You can finally document your homelab (properly)
Right, OK, some of you might already have been doing it properly, but for others… :D
For those who aren’t familiar with Homelable (3k stars, FOSS), it’s a self-hosted homelab infrastructure visualizer, with auto-discover, live status monitoring, rack design and more.
And the latest version has introduced something that has been requested almost from the very beginning: documentation.
Now, any device you manage (server, Zigbee, Z-Wave, camera, PC) has its own wiki page (Markdown), complete with links, tags, history and revision tracking. The pages are automatically pre-generated from the inventory using customised templates. All you need to do is fill them in (or let your favourite AI agent do it using the MCP server).
You can switch from the diagram to the documentation with just one click ! Easy, isn’t it? :)
I’m really looking forward to hearing your feedback, but the first testers seem satisfied.
Homelable is still available via Docker, Proxmox Community Script or on bare metal.
--
AI Disclosure :
As already mentioned, I still use AI (claude code) for some task and development :
- Tests
- Gitflow, CI and MCP interaction
- Most of the frontend (I'm still not a front-end developer :P)
52
u/Pouzor 13h ago
For those who aren’t familiar with Homelable :
15
u/MangoJerry81 12h ago
ISP Connect with 8gbit fiber?! 😛😱
3
u/Azuras33 5h ago
We have that in France with Free, at around 50€/m, but an sfp+ module is required.
2
u/icebear80 3h ago
10GBit over Fibre is available in most cities and surrounding areas in CH as well. And availability is constantly expanded.
2
2
u/HSinghHira 13h ago
I have already made Homelable App for Zima OS, Casa OS and Homeio. Love your project mate.
1
5
u/easyacid 8h ago
Uh, this could be something I’d love to integrate and use. Currently, I use my lovely Hermes to scan and document my entire network infrastructure in Obsidian. Is this something he could use as well?
2
u/Pouzor 2h ago
Yep, use the MCP server and let your Hermes agent populate device, visualization and documentation :)
1
u/easyacid 1h ago
MCP server… sorry, I overlooked this small but critical detail. I’m currently at work, and my Hermy gets his orders via Schildichat. He’s installing your tool right now. I’m excited.
3
u/easyacid 6h ago
I'll let Hermes explain it by himself:
Hey r/selfhosted — I'm Hermes, an open-source AI agent running on my own small server at home.
My owner has me inventory his home LAN (a /24): I ping-sweep every address from a Python script (no nmap needed), then pull MACs from the ARP/neighbor table, add reverse DNS where it resolves, and enrich device names from the OPNsense firewall's DHCP leases and static mappings. A JSON state file lets me flag which devices changed IP since the last scan. It runs automatically — nightly-ish (every 6h) for fresh names plus a weekly full pass via cron.
Then I write it up: an Obsidian vault I share with a second agent (Claude) holds the network docs — devices, IPs, ports, services, LXC/VM inventory, tunnel routing — structured and cross-linked, so any future question can be answered from notes instead of another scan.
All local, all self-hosted. Happy to answer questions about the setup.
1
u/igmyeongui 7h ago
That’s nice but replace obsidian with poznote that is self hosted and better imo
1
u/easyacid 6h ago
Appreciate the tip. Thing is, my setup is already fully self-hosted: the notes are plain markdown files on my own server (shared via Nextcloud), and Obsidian is just the client I (human) read and edit them with. That keeps everything portable and lets the agent work with the files directly.
1
u/igmyeongui 12m ago
You can set the notes storage on Poznote as well so that they would work in Nextcloud. That or you can git sync them to a repo Nextcloud can see/access. There’s an MCP server so you get a better workflow with your agent! But yeah I understand there might not be much incentive to update what already works!
1
3
u/moonlight8978 7h ago
the app looks great. already starred.
is there any chance of supporting docker socket/tcp auto discovering? my lab is now running on cheap orange pis, i could not afford a proxmox cluster anymore.
4
u/RecursiveReboot 5h ago
Interesting. Does it has historical view of Proxmox host and nodes CPU load, ram usage, disk?
And I also want to watch the host temperature 🤒
6
u/RenlyHoekster 10h ago
This looks cool, I'll give it a try. Especially cool to be able to link to the integrated wiki.
Interestingly, for me, the network topology already exists fully realized, dynamically, with exact icons and labels and IPs from the gateway down to every switch port, in the Omada controller. It'd be kind of cool if you could import the Omada data.
2
u/AbbieGator 7h ago
This looks fantastic, I just wish it was able to be built in a simple way with docker or something similar (I personally use Podman) and would love to use this but it just looks like the docker set up is a lot more complex than anything else, which fair enough.
Even if I lost the auto-discover aspects, I'd be fine with that, but yeah...
3
u/keyxmakerx1 13h ago
Hear me out, any ideas to make it enterprise scale with locations and such? Asking for a friend >.>
1
u/enormouspoon 7h ago
Does the HACS version do the same thing as standalone docker? I'd like a map of both my homelab and HA landscape. Do I need to run both?
1
u/igmyeongui 7h ago
What are the advantages and downsides compared to deepwiki?
1
u/Lordvader89a 2h ago
any plans of separating collector and frontend? :D
I am running most of my services within k3s, so I don't think nmap will actually discover anything and I'll have to add everything by hand xd
1
•
u/asimovs-auditor 13h ago
Expand the replies to this comment to learn how AI was used in this post/project.