I have a few options to set-up my personal journal and I intend to journal my process of how to, what’s the practical way of writing it all down with writing everything down ?
That’s the neat part, you don’t
Just some scripts and config files in external git at the moment but usually I just get my refrence form other VMs. Probably going with obsidian or other markdown editor and upload notes to somewhere if disaster strikes.
Infrastructure as code, the code that is your homelab should be the documentation of it.
Infrastructure as code
I’ve got a file called “TODO server stuff.txt” with some notes from 2019, does that count?
I like writing docs in markdown, and using mkdocs with mkdocs-material for this. With a bit of trickery, you can do templating / transclusion, and you get a useful search too.
Bookstack is such an amazing tool. Just make a shelf for Homelab, books for each aspect like VMs, docker, etc. Then have a chapter for each VM or app and them pages can be installation, running, issues, troubleshooting, significant upgrades, etc. It’s important to actually take note of it all and not just grab URLs for your resources because if those pages are removed then you’re screwed.
Knowledgebase + OIDplus + scripts/configs in git repo.
I chose local instance of Wordpress for my knowledgebase a decade ago. Today I’d probably use Bookstack.
TRILIUM. https://github.com/zadam/trilium Dig into it and check out all the examples before giving up on it. I’ve tried every note app I can imagine, and it’s hands down the best.
I am even using the API to pull shopping lists from home assistant and add them to my todo list via node-red.
With tailscale and 24/7 access, I never have to worry about missing a thought. While working out this morning, I heard a new word in a song, took me 5 seconds to stop and document that. It’s now my home for every thought, idea, plan, code snippet, recipe, home inventory, etc…
It’s 100% my trusted system. I roll GTD concepts into it with @contexts and whatnot, so I’ve even combined all other knowledge management systems into trilium.
I can’t recommend it enough.
While working out this morning, I heard a new word in a song, took me 5 seconds to stop and document that
Not to be a party pooper but I guarantee you it took longer than 5s lol.
I roll GTD concepts into it with @contexts and whatnot, so I’ve even combined all other knowledge management systems into trilium.
Can you clarify on this? I use GTD with nextcloud calendar/tasks.
+1 for Trilium. I also tried a lot of note-taking apps that are out there and Trilium is by far the most robust one.
https://silverbullet.md/ and I may start using https://d2lang.com/ too.
I use Joplin for my wiki/documentation tool. I like that it supports markdown and can be exported as markdown if needed. Also the variety of plugins is a plus.
Joplin organizes my life. Without it, I’d be lost. Like, for anything.
What size tires do I need to swap my bike? How did I configure my samba shares? How do I setup VFIO passthrough? What’s the name of that guy I hate at work? (Fuck you, Nick) How much did it cost to have the tree in my back yard removed? Can I see the invoice?
All these questions I can lookup and solve using my Joplin database. Without Joplin, life gets way harder.
Love Joplin
Mkdocs, grav
Logseq
self hosted git repository.
I setup gitea on my server and use it to track version changes of all my scripts.
And I use a combination of the wiki and .md (readme) files for howto’s and any inventory I’m keeping, like IP addresses, CPU assignments etc.
But mainly it’s all in .md formatted with markdown.
Poorly.