Homelab Organization - eviltoast

Hi all!

So I want to get back into self hosting, but every time I have stopped is because I have lack of documentation to fix things that break. So I pose a question, how do you all go about keeping your setup documented? What programs do you use?

I have leaning towards open source software, so things like OneNote, or anything Microsoft are out of the question.

Edit: I didn’t want to add another post and annoy people, but had another inquiry:

What ReverseProxy do you use? I plan to run a bunch of services from docker, and would like to be able to reserve an IP:Port to something like service.mylocaldomain.lan

I already have Unbound setup on my PiHole, so I have the ability to set DNS records internally.

Bonus points if whatever ReverseProxy setup can accomplish SSL cert automation.

  • suswrkr@discuss.tchncs.deEnglish
    9·
    5 months ago

    I run a k3s cluster for selfhosted apps and keep all the configuration and docs in a git repo. That way I have history of changes and can rollback if needed. In that repo I have a docs folder with markdown documents about common operations and runbooks.

    There are other ways to do this, but I like keeping docs next to the code and config so I can update them all at the same time. Deployed several wikis in the past but always forget to update them when I change things.

    • Hellmo_luciferrari@lemm.eeOPEnglish
      3·
      5 months ago

      I really should spend time familiarizing with maintaining a git repo. I’ll likely find one I can self host.

        • Hellmo_luciferrari@lemm.eeOPEnglish
          1·
          5 months ago

          Thank you for the suggestion. The fact that it’s FOSS wins my vote. I have been trying to go all open source where possible.

      • TCB13@lemmy.worldEnglish
        1·
        5 months ago

        If you want a git “server” quick and low maintenance then gitolite is most likely the best choice. https://gitolite.com/gitolite/index.html

        It simply acts as a server that you can clone with any git client and the coolest part is that you use git commits to create repositories and manage users as well. Very very or no maintenance at all. I’ve been using it personally for years but also saw it being used at some large companies because it simply gets the job done and doesn’t bother anyone.