this post was submitted on 17 Jun 2023
41 points (97.7% liked)

Selfhosted

46677 readers
428 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
 

I'm looking for a wiki solution (either remotely hosted or self-hosted is fine) that takes Markdown input.

Thanks.

top 37 comments
sorted by: hot top controversial new old
[–] terribleplan@lemmy.nrd.li 8 points 2 years ago (1 children)

Dokuwiki has a plugin that lets you use markdown instead of their proprietary markup.

[–] kentucky444@eslemmy.es 4 points 2 years ago (1 children)

+1 Dokuwiki. It is a little complicated than most to configure the first time, but once you have everything running, it will work without complaints. Also, the whole wiki is stored as plain text files, which is awesome for backups.

[–] xohshoo@lemmy.world 1 points 2 years ago

piling on for Dokuwiki. Have been running it personally and for an org (2 different wikis) for like 7 or 8 years. No problems, and it's own syntax is pretty easy too. I've migrated a few times too and love that it's just plain text files

[–] NuclearArmWrestling@lemmy.world 7 points 2 years ago* (last edited 2 years ago) (1 children)

I'm a big fan of Bookstack. The Docker images work great, also in Kubernetes. SSO is easy to set up as well, so if you're using something like Authentik for SSO, you can integrate it pretty easily.

By default it uses a WSYWIG editor, but you can change the default to Markdown. Also, the ability to use the built-in draw.io diagram tool is great if you are documenting anything like code paths or network setup.

[–] tjhart85@kbin.social 2 points 2 years ago

I love Bookstack!

The diagram tool can be used to markup anything. Besides the obvious, I've also put pictures as the background and then marked up those to diagram out some work I was doing around the house.

I hope the dev makes his way over here, he was very active on Reddit.

[–] whitehatbofh@lemmy.world 5 points 2 years ago

You could always just use a github repo as a wiki. It would render markdown pages in your browser, and it comes with built in version control!

[–] V4uban@lemmy.world 5 points 2 years ago
[–] naeap@sopuli.xyz 5 points 2 years ago (1 children)

I'm currently hosting a wiki.js
you can either use markdown or a visual editor

[–] kentucky444@eslemmy.es 2 points 2 years ago

My only gripe with wiki.js was the use of SQL for local storage. My wiki must be future proof and locking myself in an obscure SQL database was the deal breaker. I know that you can sync with a Git repo, but it felt like an overkill.

[–] balance_sheet@lemmy.world 4 points 2 years ago (1 children)

It's slightly out of topic of selfhosting but have you tried Obsidian?I personally feel like personal wiki must be in Obsidian.

[–] Skewer2459@lemmy.world 4 points 2 years ago (1 children)

If you use perlite you can self host a web copy. I like it much better than other wiki solutions.

[–] grumpyrico@lemmy.world 1 points 2 years ago

thx for the tip

[–] bouncybobcat@kbin.social 4 points 2 years ago* (last edited 2 years ago)

Not sure if it's the kind of thing you had in mind, but I like TiddlyWiki for certain things like note-taking. (See here for saving/hosting options).

[–] jhawthorn@lemmy.ca 4 points 2 years ago

gollum is self-hosted and uses markdown by default

[–] Smash@lemmy.self-hosted.site 4 points 2 years ago (2 children)

wikijs comes to mind, it's deploy-able with a single docker command:

docker run -d \
--name=wikijs \
--restart=unless-stopped \
--publish 8080:3000 \
--env "DB_TYPE=sqlite" \
--env "DB_FILEPATH=/wiki/db.sqlite" \
--volume wikijs:/wiki \
--volume wikijs:/wiki/data/content \
ghcr.io/requarks/wiki:2
[–] festus@lemmy.ca 2 points 2 years ago* (last edited 2 years ago) (1 children)

I also self-host WikiJS and am quite happy with it. FYI though if you're setting it up I'd instead configure it to use Postgres as the database, as I recall reading that they're planning on removing SQLite support at some point. Unfortunately though that does mean you lose a one-liner like this.

[–] Smash@lemmy.self-hosted.site 1 points 2 years ago

Okay, thanks for the heads up! I don't actively use wikijs yet, I'll setup a stack using postgres when I do

[–] cardes@social.pi.vaduzz.de 2 points 2 years ago

@Smash @firebreathingbunny I'm also quiet happy with wikijs, it has some nice features like git integration and oidc support that I'm using.

[–] ben@l.twos.dev 4 points 2 years ago (1 children)

Obsidian is a fantastic note taking app that focuses on cross-linked notes, so is effectively a personal wiki.

It has a paid add on that lets you publish it to a website, or you can just do it yourself since the files are all Markdown.

[–] Skewer2459@lemmy.world 1 points 2 years ago
[–] ElectronSoup@kbin.social 3 points 2 years ago* (last edited 2 years ago)

I use Silicon Notes; While it has 'Notes' in the title, it's just a lightweight markdown based wiki

[–] PigeonCatcher@l.antiope.link 2 points 2 years ago (1 children)
[–] fireshaper@social.belowland.com 2 points 2 years ago

It’s not selfhosted.

[–] rezz@lemmy.world 1 points 2 years ago

Try mdBook if you’re a rust person!

https://rust-lang.github.io/mdBook/

[–] easeKItMAn@lemmy.world 1 points 2 years ago (1 children)
[–] outcide@kbin.social 1 points 2 years ago

Oh cool, I thought Raneto was dead.

[–] readbeanicecream@kbin.social 1 points 2 years ago

Not sure about your use case, but check out HackMD.

[–] avalanche@kbin.social 1 points 2 years ago

I'm really liking mkdocs-material. Crazy lightweight. Very safe. And it looks nice.
https://squidfunk.github.io/mkdocs-material/

[–] dap@lemmy.onlylans.io 1 points 2 years ago

We use wiki.js at work and it is great. A nice benefit is you can track your articles in a git repository for granular change tracking.

[–] Bdking158@kbin.social 1 points 2 years ago

I stopped using it because it wasn't the best for the use case I was looking for but I'll plug SilverBullet. It is a well made program and seems very powerful from what I've seen

[–] exu@feditown.com 1 points 2 years ago

I personally use Grav. It's fully markdown bases and store the content in markdown files as well, instead of a database.
The Learn2 theme is the one for a documentation-style look. Check out the official documentation for how it looks and here's my own customized version.

[–] Dark_Arc@lemmy.world 1 points 2 years ago

I think you should specify whether you're looking for a wiki for personal use or shared use.

If you're looking for personal use, something like standard notes can be a great option.

If you're looking for shared use, and don't care about encryption, wiki.js is IMO your best bet.

There's currently no option that does both. Skiff exists as an encrypted collaborative notes option but it doesn't (to my knowledge) allow any kind of self hosting.

[–] easeKItMAn@lemmy.world 1 points 2 years ago

Simple, lightweight: raneto

[–] Dark_Arc@lemmy.world 1 points 2 years ago

I think you should specify whether you're looking for a wiki for personal use or shared use.

If you're looking for personal use, something like standard notes can be a great option.

If you're looking for shared use, and don't care about encryption, wiki.js is IMO your best bet.

There's currently no option that does both. Skiff exists as an encrypted collaborative notes option but it doesn't (to my knowledge) allow any kind of self hosting.

[–] NuclearArmWrestling@lemmy.world 0 points 2 years ago* (last edited 2 years ago) (1 children)

I'm a big fan of Bookstack. The Docker images work great, also in Kubernetes. SSO is easy to set up as well, so if you're using something like Authentik for SSO, you can integrate it pretty easily.

By default it uses a WSYWIG editor, but you can change the default to Markdown. Also, the ability to use the built-in draw.io diagram tool is great if you are documenting anything like code paths or network setup.

[–] kentucky444@eslemmy.es 2 points 2 years ago

I researched using Bookstack but you can access the pictures even if you do not have an account and have the right URL, anybody can see the picture/attachment file in any browser.

Not having well-implemented access control was a big No No for us.

load more comments
view more: next ›