September 27th, 2024

BookStack: Simple and Free Wiki Software

BookStack is a free, open-source documentation platform with a WYSIWYG editor, customizable settings, multi-language support, built-in diagram tools, and various authentication methods, including a demo instance for exploration.

Read original articleLink Icon
BookStack: Simple and Free Wiki Software

BookStack is a free, open-source platform designed for organizing and storing information in a simple and user-friendly manner. It features a WYSIWYG page editor and organizes content into three main categories: Books, Chapters, and Pages. Users can search content at various levels and link directly to specific paragraphs, enhancing connectivity within documentation. The platform is configurable, allowing users to customize names, logos, and visibility settings. Built on PHP and the Laravel framework, BookStack can run on minimal server resources. It includes built-in diagram creation tools, supports multiple languages, and offers an optional Markdown editor with live previews. Authentication options are versatile, including social logins and enterprise solutions like SAML2 and LDAP. Additional features include multi-factor authentication, dark and light modes, and a comprehensive role and permission system. Users can try BookStack through a demo instance, which resets every half hour, providing a hands-on experience of its capabilities. The latest updates and project news can be found on the BookStack blog, which also highlights community contributions and sponsorships.

- BookStack is a free and open-source platform for documentation.

- It features a simple interface with WYSIWYG editing and multi-language support.

- Users can customize settings and utilize various authentication methods.

- The platform includes built-in diagram tools and supports Markdown editing.

- A demo instance is available for users to explore BookStack's features.

Link Icon 14 comments
By @ssddanbrown - 7 months
Thanks for sharing my project! I started building BookStack just over 9 years ago to suit a need at work, and have been improving & maintaining it since. I left full time employment three years ago and have been focusing on BookStack since, with my living costs now covered via project donations, sponsorships & support services, and the growth of these continue as shown in my blogpost here: https://www.bookstackapp.com/blog/9-years-of-bookstack/#fina....

The platform has been designed for ease-of-use, with mixed-technical-skill workplace use in mind. The design and content structure is (purposefully) quite opinionated though so does not suit all use-cases, but for many it works quite well.

Technically it's built as quite a technically simple PHP/Laravel/MySQL stack with custom JavaScript sprinkled in where needed. The default WYSIWYG editor is TinyMCE based, although due to TinyMCE license changes I'm currently building a lexical-fork-based new editor.

If you'd like to understand the project more, a project FAQ can be found on our site here: https://www.bookstackapp.com/about/project-faq/

[0]

By @punchmesan - 7 months
BookStack is great if you're small. There's no file locking/conduct management when two people are editing the same page and there's no co-authoring. I used it for docs at a startup I was in around 2018 and this lack of feature really got in our way once we grew to more than 10 people.

The feature is still missing today, I get email updates from the same ancient GitHub issue often of people asking for it and the dev responding that they don't like the idea of systematically preventing conflicts. Which is fair, if I had the skill and inclination I would have forked the project and just done it myself. But I'm not a software engineer, so I had no choice but to use different software that fit my needs.

If you're a really small shop BookStack has a very nice and clean UI and is a great wiki-type offering. At any kind of scale the cracks start to show, though.

By @brainzap - 7 months
We use it at work and its ok. Missing permalinks and the permission concept does not fit our usecase.
By @summermusic - 7 months
Bookstack has been awesome for helping me build out my tabletop roleplay campaigns with friends and for storing recipes. Funnily enough, these are things where a “book” metaphor really makes sense! My spouse uses it has a general knowledge base for their projects and all sorts of topics.

Are there more featureful and flexible wiki softwares out there? Sure. But Bookstack is my favorite by far because 1) I never feel lost and overwhelmed by the amorphous structure and dizzying array of features I don’t need and 2) it is the easiest to self-host and maintain of the many self-hosted wikis I trialed in my homelab ~5 years ago.

By @alxjsn - 7 months
Outline is another great wiki that I have been self-hosting for a couple years now: https://github.com/outline/outline
By @BodyCulture - 7 months
Would be great if we could actually export a book as pdf or in a format that could be printed or worked on in book publishing software. I could not find that option, is it available?
By @seriocomic - 7 months
Having tried this (when searching for a self-hosted documentation system), I abandoned it due to the inability to change the reference to the book-specific-nomenclature. Still, a nice project in all other regards. (I ended up using Notion due to its flexibility, but still hope for a self-hosted notion clone).
By @gjsman-1000 - 7 months
It’s look gorgeous, it feels gorgeous, but I’m sadly stuck in my organization because the OAuth support doesn’t expose enough knobs. (I.e. what if it isn’t OIDC? What if it requires one non-standard scope and nothing else? What if there’s no encryption key seemingly to be found? Etc.)
By @kkfx - 7 months
It's a very nice project, I hope a day they choose to support PostgreSQL and SQLite though, they are much more popular these days and chances you already use both, just need to add a DB are high.
By @alexissantos - 7 months
We use this at my company and I'm a fan!
By @shiroiushi - 7 months
In a nutshell, how is this different from MediaWiki, the software used by Wikipedia?
By @kaushikc - 7 months
I love free book browsing and hosting. This looks like a good project.
By @arunc - 7 months
Good to see simple wiki / confluence alternatives. But confluence is here to stay, with all it's rich features.

I switched jobs and thus move away from confluence to ADO wiki and life is never endingly painful for internal knowledge management!

Either there are 100s of word docx or there's confluence that can be easily queried, with various other capabilities using it's plugins for draw.io and mermaid.js.

Markdown for large tables is just silly and hard to maintain. AsciiDoc is great, but a bit too much for docs that are shared with product teams.