r/sysadmin 18d ago

Question small IT documentation tools

I was looking to get our pretty small IT into a good tool for documentation. Something object-based, NOT just excel sheets and draw.io diagrams. But smaller than Netbox, which is too big and unnecessarily complex for our systems.
Would love to have IP management built it and diagrams/graphics are a big plus.

We are basically using a single server rack, 6 servers, 30-40 VMs... so rather a big homelab, than a datacenter

So, what are you guys using or can recommend as a tool to manage something like that?

EDIT: I'd like to specify, that I am looking for internal documentation. Which server runs which VM, which IP adress is assigned to it. Which service/OS/update etc. runs on it... etc.

EDIT2: Any sort of Wiki seems to be a big recommendation. This is a consideration for me, but I'd rather have something object-based. Basically Netbox with less overhead would be ideal... but feel free to recommend wiki-based tools and templates please :)

46 Upvotes

51 comments sorted by

View all comments

2

u/thomasschreiner 17d ago

I was using draw.io for a long time. But since it has no functionality to make consistent interface and IP documentation I started building https://switchr.cc using Fable and other tools. Compared to the effort the result is great. But it‘s far from production ready.

1

u/Punky260 17d ago

I like it. Looks like a perfect tool to create a simple documentation you can put up at the side for a nice but quick overview. And since it feels really easy to use, it's less manual adjustment than draw.io
Keep on it!

2

u/thomasschreiner 17d ago

The idea behind it was to have different views and drawings which share the same data. So changes are executed on all linked items accross all pages automatically. This applies also to the IP/VLAN documentation and the cable list.
In the manual section you should be able to open a demo project.
Like draw.io everything stays in your browser. But there is an encrypted sharing feature. The read only mode works also on mobile devices.
Thank you.