42
submitted 9 months ago* (last edited 9 months ago) by CowsLookLikeMaps@sh.itjust.works to c/selfhosted@lemmy.world

There are a ton of options listed on the Awesome Selfhosted list. I'm on the search for a FOSS option that I can use to document my homelab and personal tech projects.

Right now, I'm leaning towards wiki.js

Edit: similar question

all 27 comments
sorted by: hot top controversial new old
[-] Matt@lemdro.id 30 points 9 months ago

DokuWiki for simplicity. Everything is a text file that can just be copied to a web server. It doesn't even require a database. And since all the wiki pages are plaintext markdown files, they can still be easily accessed and read even when the server is down. This is great and why I use DokuWiki for my server documentation as well.

[-] dlundh@lemmy.world 3 points 9 months ago

This. For exactly this reason.

[-] nimmo@lem.nimmog.uk 2 points 9 months ago

I was going to say that the big downside to that would be a lack of any kind of version control, but I guess if you need that you can always use git and just commit changes there and (optionally) push them to a repository somewhere.

[-] Matt@lemdro.id 3 points 9 months ago

Doku still has the typical wiki style version control. It uses other text files to keep a changelog without cluttering the markdown file.

[-] JASN_DE@lemmy.world 9 points 9 months ago

I run a Bookstack instance which works quite well for me.

[-] avidamoeba@lemmy.ca 5 points 9 months ago

I did a similar inquiry a few months ago. I tried DocuWiki and Wiki.js. Ended up with Wiki.js. It's very easy to setup with docker-compose. Everything is stored in Postgres but it also exports to the local filesystem in Markdown. Its advanced built-in search is pretty good.

[-] m_randall@sh.itjust.works 4 points 9 months ago* (last edited 9 months ago)

I just spent a week evaluating all the popular choices to document an overlay network I’m standing up. All I want is a simple markdown interface to write notes in. My goal was something with a very simple UI, markdown, and very light weight.

MediaWiki, Bookstack, and WikiJS (or JSWiki) were good but they were too much for what I needed. I ended up with stumbling on gollum and really like it. It’s very very simple, fast, and clean. I wrote a one line cronjob and now I’m backed up to gitlab.

https://github.com/gollum/gollum

I really like WikiJS but its development is stuck for a long time now. No v3 in sight.... Sadly

I am using latest v2 for now, but I am looking for alternatives. Pro for WikiJS: S3 Backend, easy to use, WYSIWYG-Editor

Outline is a hell to selfhost, even if it starts, login via Email / Password is not enabled by default. You need to login with Github or similar... Never again

This is my experience with wikis so far.

[-] words_number@programming.dev 4 points 9 months ago

I'm administering a wiki.js instance. Despite it being written in node, it's a pretty nice wiki with a lot of modern features builtin. The only other wiki I've ever setup and used was mediawiki, which is obviously a complete legacy php clusterfuck where you need add-ons (which are terrible to install and configure) for everything.

[-] johntash@eviltoast.org 4 points 9 months ago* (last edited 9 months ago)

Bookstack is really nice and user friendly. It's probably one of my favorites.

Dokuwiki is simple and stores files in plaintext.

I haven't used wiki.js much but I've heard good things about it too.

Another option if you don't need to share the wiki with anyone would be a note tool like Trilium. It has built in support for stuff like mermaid or excalidraw diagrams.

Don't forget to setup backups for whatever wiki you do go with, and make sure you can restore them when your wiki is broken ;)

[-] paddirn@lemmy.world 3 points 9 months ago* (last edited 9 months ago)

I'm probably the biggest simpleton in this thread, but I was just looking at this earlier and TiddlyWiki still seems like the easiest of the easiest. It's literally just an html file that requires pretty minimal setup to get going. Nothing else seems to even come close. I've been using it for a couple of years as a sort of internal departmental job aid, just basic information for our group and it's pretty straight-forward.

[-] exu@feditown.com 2 points 9 months ago

I previously used WikiJS, but since about a year ago I switched to Grav.

The really nice thing is not having an additional database anymore. It's really just markdown pages, config files and php plugins.

By default it looks like a blogging platform, but with the learn2 theme it also works pretty well as a documentation website. The official docs are written using that theme.

I wasn't completely happy with the defaults though so I did some modifications for my own wiki. Some limited knowledge in HTML, CSS is required and PHP or Javascript don't hurt either.

You can find the theme, plugins and pages in my repo as well if you'd want to use any of it.

[-] snekerpimp@lemmy.world 2 points 9 months ago

Recently went through this. Needed a quick and dirty knowledge repository for work. Ended up running bookstack, wiki.js and dokuwik in docker containers, building the same wiki in each and then messed around with it. Landed on bookstack and wiki.js, bookstack because I liked the end user UI and wiki.js because of the backend. I think most my co-workers use the bookstack one.

[-] Fly4aShyGuy@lemmy.one 1 points 9 months ago

Bookstack looks really cool, considering it for a project at work but I don't like how you can't have pages outside of books. We're looking to put together a general knowledge base that could span many different types of equipment and manufactures. For that reason I'm leaning towards wiki.js due to the search and tag browsing, but basically planning on doing the same installing those same 3 to check them out.

[-] WeirdGoesPro@lemmy.dbzer0.com 1 points 9 months ago

Another thing with bookstack is that if your local IP changes for any reason, it breaks all the images and it is pretty frustrating to get them working again. They added a command to try to fix this, but I could never get it to work correctly.

I ended up switching to wiki.js and haven’t had a single problem since, but I do miss the super sleek look of bookstack sometimes.

[-] Unsafe@discuss.online 1 points 9 months ago

Gollum. Hit integration is required if you value wiki content.

[-] SeeJayEmm@lemmy.procrastinati.org 1 points 9 months ago

I've been using Wiki.js since I asked this question a few months ago. I've been pretty happy with it. Stores data in text files using markdown and can synchronize a number of backends. I've got mine syncing to a private github repo.

[-] CowsLookLikeMaps@sh.itjust.works 2 points 9 months ago

Thanks! I used the search function but it wasn't showing up for some reason. I'll link to it in the OP.

[-] SeeJayEmm@lemmy.procrastinati.org 2 points 9 months ago

Np. I wasn't trying to imply anything. I asked a different question, it just had overlap so I thought you might find it useful.

[-] CowsLookLikeMaps@sh.itjust.works 2 points 9 months ago

Likewise :)

[-] JoeKrogan@lemmy.world 1 points 9 months ago

I use raneto. Built using js. Flat file and uses markdown.

[-] SteveDinn@lemmy.ca 1 points 9 months ago

Bookstack is what I self host, but this is the best pure markdown editor I've found: https://markdownlivepreview.com/

[-] zaphod@lemmy.ca 1 points 9 months ago* (last edited 9 months ago)

Honestly, for personal use I just switched to straight Markdown that I edit with Vim (w/ Vimwiki plugin) or Markor on Android and synchronize with Syncthing. Simple, low effort, portable, does enough of what I need to get the job done.

And if I wanna publish a read-only copy online I can always use an SSG.

[-] homegrowntechie@lemmy.world 1 points 9 months ago

Trilium for personal use cases. It is very easy to host, edit, and navigate. Public sharing is easy too.

this post was submitted on 09 Jan 2024
42 points (100.0% liked)

Selfhosted

39677 readers
419 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 1 year ago
MODERATORS