this post was submitted on 18 May 2025
136 points (100.0% liked)

Selfhosted

46688 readers
2179 users here now

A place to share alternatives to popular online services that can be self-hosted without giving up privacy or locking you into a service you don't control.

Rules:

  1. Be civil: we're here to support and learn from one another. Insults won't be tolerated. Flame wars are frowned upon.

  2. No spam posting.

  3. Posts have to be centered around self-hosting. There are other communities for discussing hardware or home computing. If it's not obvious why your post topic revolves around selfhosting, please include details to make it clear.

  4. Don't duplicate the full text of your blog or github here. Just post the link for folks to click.

  5. Submission headline should match the article title (don’t cherry-pick information from the title to fit your agenda).

  6. No trolling.

Resources:

Any issues on the community? Report it using the report flag.

Questions? DM the mods!

founded 2 years ago
MODERATORS
 

Hello, how do you document your home lab? Whether it's a small server or a big one with firewall and more nodes. I have a small pc with Proxmox and there I have a VM with OpnSense. After I've entered my VPN as a interface in OpenSense, I noticed that I slowly lose the overview with the different rules that I have built in my firewall. And I know that my setup is relatively easy in comparison to others here in this community. I want to have a quick Overview at the various VMs, like the Lxc container, Docker containers that I have in this and the IP addresses that I have assigned to them. I search for a simple an intuitiv way for beginners.

(page 2) 18 comments
sorted by: hot top controversial new old
[–] higgsboson@dubvee.org 2 points 1 week ago* (last edited 1 week ago)

Not much, really. I do comment changes to config files and such.

[–] fmstrat@lemmy.nowsci.com 2 points 1 week ago (1 children)

Every time I set up anything, I do one of two things:

  • If it's container based, it gets a commented docker compose file in my custom orchestration

  • If it's on a host system, the changes are scripted and commented in a setup script, which are run on new machines. If the acrit is specific to one machine, it is configured as such

I find in-setup docs to be best for a home lab, plus if I have to replace hardware, it's fast.

Fun fact, I do it for laptops and desktops, too.

[–] CapitalNumbers@lemm.ee 2 points 1 week ago (1 children)

this is basically what i ended up doing to - glad to see my approach verified somewhat ha ha!

but yeah, in general whenever i make a change / add new service, i always try and add those steps to some sort of setup.sh / docker-compose

[–] fmstrat@lemmy.nowsci.com 1 points 1 week ago

Yea comes in super handy when you always want dropbear SSH for remote unlock, or making sure both RAID disks boot, etc.

I do it for all my software setup, too. A shell script for each, then a for loop that asks to run each. But I also made https://github.com/fmstrat/gam, so maybe I just like overkill bash.

[–] corsicanguppy@lemmy.ca 1 points 1 week ago

In gitlab.

In the terraform project that builds it. Or in the cinc.sh config that makes it go.

MD lets me add diagrams.

[–] TCB13@lemmy.world -5 points 1 week ago (3 children)

If it need documentation means things are over the line when comes to complexity and I should scale down / simplify. :)

Complexity and over-engineering are a serious problem, I really try to keep it as simple as possible so I don't have to waste time managing it, dealing with updates and potential security issues. Simple code/infrastructure breaks less and has less potential insecure points.

load more comments (3 replies)
load more comments
view more: ‹ prev next ›