Documentation system for IT infrastructure reddit / selfhosted ---------------------------------------------------------------------- mcc0unt · 2023-10-24 23:28 Hi together, after googling my ass wound, I‘m wondering if you‘ve got some ideas what could fit my needs. As an admin I‘m in the need to store information about customers, like IP addresses and ranges, their credentials, possibly user credentials and software licenses (perpetual and recurring), maybe even hardware information etc. Are you aware of sth like that? Snipe-IT doesn’t seem to be an option as it does still not support subscription based licenses (why ever…) and GLPI is not tenancy based. Thanks in advance! ---------------------------------------------------------------------- moltenwalter · 2023-10-25 00:36 Obsidian ---------------------------------------------------------------------- zeitue · 2023-10-25 00:42 At work we use Logseq for notes and we store software licenses in vaultwarden. I also have all of the docker compose files and other required files in a git repository with a readme per compose stack. ---------------------------------------------------------------------- amit510 · 2023-10-25 01:05 Dokuwiki is the way to go! Custom make all the pages using tables, etc. ---------------------------------------------------------------------- ReinoutWolter · 2023-10-25 01:10 I've been wanting to build a system just like this for a while. I started just jotting down all the information in a wiki and then never found any benefit from building a more structured system that the simple wiki already provides. Happy to discuss in further detail, maybe even talk about prototyping something basic if you have some good suggestions. ---------------------------------------------------------------------- tankerkiller125real · 2023-10-25 01:57 DigitalOcean Netbox ---------------------------------------------------------------------- SirLoopy007 · 2023-10-25 02:39 My passwords.txt file on the desktop is not okay? ---------------------------------------------------------------------- DIYSRE · 2023-10-25 02:43 So what we're looking at is probably two or three systems here. I can't help you on what systems integrate. **Documentation** This is for general documentation. SOPs, etc. I generally advise documentation be stored in Markdown. This is after decades of having to migrate systems or being locked into a documentation system because a migration path was too timely. Markdown is *ultra* portable and easy to store/backup. You can get change management interfaces for it, or store it in Git if you have to. Even something like mdwiki would do the trick in a pinch. The value you see out of this lies in how well you keep it organized and how well you use it. **Client Secrets** This will be served by a secrets manager like [https://github.com/Infi sical/infisical](https://github.com/Infisical/infisical) I've never used it but I've seen it recommended and it seems like a good project. I've used things like KeePass, Bitwarden andOnePass. My preference would probably be none of them, but I do like Bitwarden for a personal vault. **Asset Management** This should be handled by an asset management system. This is for things like licenses, hardware, etc. Snipe-IT was actually my pick for this. Just for assets though, nothing else. ---------------------------------------------------------------------- GlumKnowledge5933 · 2023-10-25 02:44 You need a ITSM ---------------------------------------------------------------------- GlumKnowledge5933 · 2023-10-25 02:52 Itop Is a excelent Solution for this, Is free AND you can selfhosted. If you stuck with the config, you can answer me AND i can help you ---------------------------------------------------------------------- panjadotme · 2023-10-25 03:44 > after googling my ass wound say what now? ---------------------------------------------------------------------- Psychological_Try559 · 2023-10-25 03:53 Agreed that Snipe-IT doesn't seem to be the right tool for you, but it may end up being useful for what it does. As others have said, I'd look at a wiki or *makes nauseous sound* confluence (as much as I'd recommend other wikis, it's a popular choice) for general notes. I'd love to find something that can integrate tables from wherever that is set, but I haven't found anything like that. Please take care with passwords though. While I personally prefer KeePass, Bitwarden is the go to choice and is centralized allowing for easy revokation & mass password changes, and likely a better fit for you. TL;DR: I'd go with a wiki for information and Bitwarden for passwords (and maybe credentials). If these don't work I'd be curious to know why, and what you find that's better! ---------------------------------------------------------------------- Psychological_Try559 · 2023-10-25 03:56 I haven't heard of infisical, but I AM curious what it has that beats KeePass & Bitwarden for you? ---------------------------------------------------------------------- DIYSRE · 2023-10-25 04:09 It seems like an alternative to HashiCorp Vault, so integration into deployment pipelines would be a huge bonus. OP doesn't specify what they would use the secrets manager for, but Infisical seems to be a good cross between something like Bitwarden and something like Vault. ---------------------------------------------------------------------- Perpetual_Nuisance · 2023-10-25 04:48 >after googling my ass wound WTF did you say? ---------------------------------------------------------------------- turbanist · 2023-10-25 05:10 +1 for Netbox + Vaultwarden ---------------------------------------------------------------------- ReinoutWolter · 2023-10-25 05:50 I like how this sub is so laser focused on self hosted apps that most the answers just completely glossed over the "ass wound" part and provide useful feedback. You could open with I want a self hosted app for keeping track of my serial murders, and people would come back with some great options. ---------------------------------------------------------------------- Tibuski · 2023-10-25 06:20 Take time to read/try/learn about Netbox, it should be perfect for you. At Work, I deployed Netbox and, even if the teams were reluctant at first, they finally saw the benefits and slowly gave up their infamous excel sheets 😉 For general documentation and scripts, I tried to push people to MKdocs-material automatically updated from a Gitea repository but people are too allergic to Markdown... ---------------------------------------------------------------------- Cybasura · 2023-10-25 07:05 "After googling my ass wound" is not something I expected to hear today, but here we are ---------------------------------------------------------------------- Simon-RedditAccount · 2023-10-25 07:06 Probably not your case, but that's what I use for my homelab: * OIDplus for keeping OIDs, IPs, domain etc * local-only Wordpress as a knowledgebase. Today I'd probably chose Bookstack, but it did not exist 11 years ago.... ---------------------------------------------------------------------- Simon-RedditAccount · 2023-10-25 07:10 A unique, one-time offer! Upgrade your passwords.txt to passwords.kdbx for free! /s ---------------------------------------------------------------------- metyaz · 2023-10-25 08:03 https://www.bookstackapp.com/ Most of it resembles Confluence that is a popular documentation platform in the IT world... ---------------------------------------------------------------------- spuddman · 2023-10-25 08:46 I've used Dokuwiki in the past, but at the end of last year, I swapped everything to Notion. I have everything from SOP, licenses, Hardware DBs, and Network DBs stored in one place. For creds, I store these separately in Bitwarden. ---------------------------------------------------------------------- willharwell · 2023-10-25 08:48 Check out the client management documentation for ITFlow. [https://docs.itflow.org/](https://docs.itflow.org/) It's modularized so you can turn off the parts you don't need, like accounting or ticketing. ---------------------------------------------------------------------- Just-Sec · 2023-10-25 10:21 Hudu , Docusnap, Gira. We use Hudu, but for us it´s limited in function. ---------------------------------------------------------------------- PaceSnake · 2023-10-25 12:35 Netbox for IPAM and DCIM, Vaultwarden for passwords, snipe-it for assets, and wikijs for documentation. ---------------------------------------------------------------------- EscapismMisfit · 2023-10-25 15:38 I say you can consider shelf ([https://github.com/Shelf- nu/shelf.nu](https://github.com/Shelf-nu/shelf.nu)) for asset management as a snipe alternative. ---------------------------------------------------------------------- servergeek82 · 2023-10-25 17:23 Why not upgrade to SuperSecurePasswords.txt Just need to download RAM now.... Gonna have to whoogle my ass wound for it ---------------------------------------------------------------------- Beautiful_Poem_7310 · 2023-10-25 17:23 One of the three 1. vscode \`MarkDown\` and github. 2. \`mdbook\`, however you will have to install \`mdbook-katex\` for Katext formula. 3. \`passwordstore\` 4. [https://sourceforge.net/projects/pass- simple/](https://sourceforge.net/projects/pass-simple/) if you wan't templates and YAML with 1. passwordstore. ---------------------------------------------------------------------- Eldiabolo18 · 2023-10-25 17:24 Netbox or nothing! ---------------------------------------------------------------------- Not_your_guy_buddy42 · 2023-10-25 17:28 I believe it's German slang (to do xyz until your butt's raw) except bad translation lol ---------------------------------------------------------------------- Binou31 · 2023-10-25 19:10 Best choose ever. I approve this list ---------------------------------------------------------------------- imnotsurewhattoput · 2023-10-25 20:28 Hudu is what I use and it’s amazing ---------------------------------------------------------------------- kuerious · 2023-10-25 22:17 Anyone else ever heard of (or using) iTop? ---------------------------------------------------------------------- blind_guardian23 · 2023-10-25 22:33 Would recommend using my roles for netbox and vaultwarden: https://github.com/selfhostx/ansible Btw. ansible can use netbox as dynamic inventory. ---------------------------------------------------------------------- ZAFJB · 2023-10-26 11:50 Another vote for Bookstack. We've been using it in a business for years now. Easy to setup and configure. Easy to use. Just works. ---------------------------------------------------------------------- mcc0unt · 2023-10-29 16:04 So, first of all, thank you all so much for your input; I really appreciate it!! Secondly, I‘m sorry for that confusing term of „googling my ass wound“, that’s kind of a terrible translation from german, but y‘all got the point :D I’m going to upvote every answer as I’m really thankful to discuss about that topic. A secure stack, looking at secrets and passwords, it’s definitely wise to split that between the documentation itself and something that’s build for passwords like Bitwarden. I’m looking forward to try ITFlow because it’s looking like the combination I searched for, but hidden behind VPN as it’s still beta and they are not sure if there are security concerns for themselves. So long story short: thanks and keep hosting your own stuff! ---------------------------------------------------------------------- mcc0unt · 2023-10-29 16:06 As written in my „closing“ answer, that looks so promising, thanks for that heads up! ---------------------------------------------------------------------- lockstock27 · 2023-10-31 21:20 I'd recommend netbox ---------------------------------------------------------------------- thespoook · 2023-11-28 10:51 >Itop Hi, sorry to hijack this thread, but you seem familiar with iTop. I'm just experimenting with it now. I can't seem to find a CI or module for credential management. For example, if I have a web application associated with a contact, there are no "login" fields? I assume this is for security, as iTop is not supposed to be a password manager - I'm just checking that I didn't miss anything. Thanks in advance for any advice.