Simplest For End User Wiki/Knowlege Repo for the end user

Selfhosted@lemmy.world – 13 points – 11 months ago

I am trying to set up a repository of knowledge for my job. Was thinking a wiki, but I need something that I can make as simple as possible for the end user, as some of them are not familiar with markdown or html. Is there a self hosted option that is dumb easy simple to navigate and edit for the end user?

I chose Bookstack for the same situation. It's dead simple in usage and maintenance. No issues yet!

Tried bookstack first, but setting it up with docker was giving me issues and didn’t want to try bare metal/VM yet. It’s on my list to fiddle with though, thank you.

Here you go, this is my docker compose. You can modify the pieces as you see fit.

version: '3' services:

Bookstack

bookstack:
    image: lscr.io/linuxserver/bookstack
    container_name: bookstack
    environment:
        - PUID=${PUID}
        - PGID=${PGID}
        - APP_URL=
        - DB_HOST=bookstack_db
        - DB_USER=bookstack
        - DB_PASSWORD=${BS_DB_PASS}
        - DB_DATABASE=bookstackapp
    volumes:
        - ${DATA_DIR}/bookstack:/config
    ports:
        - 6875:80
    restart: unless-stopped
    depends_on:
        - bookstack_db
bookstack_db:
    image: lscr.io/linuxserver/mariadb
    container_name: bookstack_db
    environment:
        - PUID=${PUID}
        - PGID=${PGID}
        - MYSQL_ROOT_PASSWORD=${BS_DB_PASS}
        - TZ=${TIMEZONE}
        - MYSQL_DATABASE=bookstackapp
        - MYSQL_USER=bookstack
        - MYSQL_PASSWORD=${BS_DB_PASS}
    volumes:
        - ${DATA_DIR}/bookstack/mariadb:/config
    restart: unless-stopped

I notice in yours you dropped the - APP_URL=https://bookstack.example.com that linuxserver and solidnerd have in their compose files. I will comment that out and see if that helps my issues. would redirect to a 404 page every time.

That's an error on my part, apologies. I copy/pasted and tried to redact my url from the APP_URL=https://bookstack.example.com section and ended up deleting the entire line; yay replying from mobile. :|

I currently use Bookstack on Docker in Unraid but the above docker compose snippet is from when I used a debian VM with docker installed on it to run my docker stacks.

Wiki.js is pretty simple and the solution I settled for after testing multiple options. Other examples can be found here: awesome-selfhosted

Saw everything on awesome-selfhosted, just wasn’t sure which out of the plethora of options out there was the easiest for the end user.

Another vote for wiki.js. It has tons of authentication options and integrations. The mobile web interface is a tad clunky but usable.

I recently tested the most recommended wiki software and I settled on Wiki.js. Trivial to setup with docker-compose. It stores everything in its database but can continually dump it in various formats and places. I have it dump to the local filesystem. It spits out Markdown files. It can run on SQLite but it defaults to Postgres which provides better search. It's got simple RBAC too.

This was the first one I set up. I enjoy it, but I need to see if someone who only knows how to use gmail can operate it.

I taught my users markdown with StackEdit, a side-by-side WYSIWYG / Markdown generator. It opened some doors for us in terms of the tech we could use behind the scenes.

Something like docuwiki maybe, it looks like Wikipedia so everyone would immediately feel at home there.

I will spin one of those up. Thank you for the suggestion.