• Skip to main content
  • Skip to after header navigation
  • Skip to site footer

Free-Mail

  • Events
  • Images
    • Instagram Goodness
  • Music
  • News
  • Software

Document with BookStack, an open source Confluence alternative

Document with BookStack, an open source Confluence alternative: Document with BookStack, an open source Confluence alternative ssddanbrown Tue, 01/03/2023 – 03:00

BookStack is an open source, web-based documentation system, that allows you to create a structured knowledge store for personal, team, or company use. BookStack focuses on ease-of-use and design to provide an experience suitable for an audience with, potentially, mixed skills in technology. It’s built upon the PHP framework Laravel, with MySQL or MariaDB used as a datastore.

I built BookStack after attempting to find a documentation or wiki system for my workplace. Confluence was the closest option to suit my requirements but the user-based pricing introduced a barrier. The closed nature of Confluence also raised questions to the longevity of the documentation I’d be building. In the end, I decided to build my own platform to suit my needs. I released it under the MIT license to give back to the open source community that I’d come to love and benefit from over the years.

Content hierarchy and organization options

To keep things familiar and intuitive, BookStack makes use of real-world book terms to describe its organization structure. Documentation content is created as a “Page”:

  • Pages belong to a specific “Book”.
  • Within a Book, Pages can optionally be grouped up into “Chapters”.
  • As your documentation grows, you can then use “Shelves” to categorize Books, with Books being able to be part of multiple shelves if needed.

This structure sits at the heart of BookStack, and can often be the love-it-or-hate-it deciding aspect of whether BookStack is suitable for your use case.

IImage of a view of a
Image by:

(Dan Brown, CC BY-SA 4.0)

More open source alternatives
Open source project management tools
Trello alternatives
Linux video editors
Open source alternatives to Photoshop
List of open source alternatives
Latest articles about open source alternatives

Upon this core hierarchy, BookStack also provides tagging, user favorites, and advanced search capabilities to ensure content remains discoverable.

Writing documentation

The primary method of writing documentation in BookStack is through the use of its what-you-see-is-what-you-get (WYSIWYG) editor, which makes use of the open source Tiny project. This editor provides a range of content formats including:

  • Various header levels
  • Code blocks
  • Collapsible blocks
  • Tables
  • Images
  • Links
  • iFrame embeds
  • Alert callouts
  • Bullet, numbered and tasks lists
  • Drawings (through intregration with the open source diagrams.net)
An image of editing a
Image by:

(Dan Brown, CC BY-SA 4.0)

If you prefer Markdown, you can use the built-in Markdown editor, which provides a live preview and supports the same feature set as the WYSIWYG editor. If permission allows, you can even jump between these editor options depending on the page you’re editing.

How your data is stored

Documentation is stored within a MySQL or MariaDB database in a relatively simple HTML format, in addition to the original Markdown content if Markdown was used. A lot of design and development decisions have been made to keep this HTML format simplistic. It uses plain standard HTML elements where possible, to ensure raw documentation content remains open and portable.

Uploaded images, attachments, and created drawings are saved on the local filesystem but can optionally be stored in an s3-compatible datastore like the open source MinIO.

To keep your content accessible, there are built-in options to export content as PDF, HTML, plain text, or Markdown. For external consumption, there’s a HTTP REST API and a webhook system. In terms of extension, a “logical theme system” allows running of custom PHP code upon a wide range of system events.

Ready for business

BookStack comes with a range of features to support business environments. Support for a range of authentication options are built-in, including SAML2, OpenID Connect, and LDAP allowing easy single-sign-on usage with platforms such as KeyCloak. MFA options are available and can be mandated based upon role. An audit log provides full visibility of modification activities across an instance.

?image of the BookStack audit log activity list.
Image by:

(Dan Brown, CC BY-SA 4.0)

A full role-based permission system provides administrators full control over create, view, update, and delete actions of system content. This allows per-role system defaults, with options to set custom permissions on a per-hierarchy item basis.

A community of support

After being active for over 7 years, the community for BookStack has grown with various avenues for discussion and support. We now have:

  • Our documentation site
  • Video guides on YouTube
  • A subreddit
  • An active GitHub issues list
  • Paid-for business support

If you want to play with BookStack, you can try it out on our demo site. To learn how to set up your own instance, visit the installation page of our documentation.

BookStack is an open source, web-based documentation system, that allows you to create a structured knowledge store for personal, team, or company use.

Stack of books for reading
Image by:

Opensource.com

Alternatives
Documentation
Business

What to read next
Creative Commons LicenseThis work is licensed under a Creative Commons Attribution-Share Alike 4.0 International License.
Register or Login to post a comment.

: Opensource.com ssddanbrown

Supporting Open Source.

Have you tried: Visiting Port Elizabeth?

Share this:

  • Share on Facebook (Opens in new window) Facebook
  • Share on X (Opens in new window) X
  • Share on Pinterest (Opens in new window) Pinterest
  • Email a link to a friend (Opens in new window) Email
  • More
  • Share on Tumblr (Opens in new window) Tumblr
  • Print (Opens in new window) Print
  • Share on LinkedIn (Opens in new window) LinkedIn
  • Share on Reddit (Opens in new window) Reddit
Published on 3 January 2023 by Alan Category: SoftwareTag: Alternative, BookStack, Confluence, DOCUMENT, Open, Source

Boris + Klub – Tributo a Bob Marley

Boris + Klub – Tributo a Bob Marley – a Africa interest event taking place on 2018-06-09 …

Read moreBoris + Klub – Tributo a Bob Marley

The insect brain: we froze ants and beetles to learn how they remember their way home

The insect brain: we froze ants and beetles to learn how they remember their way home: We humans are …

Read moreThe insect brain: we froze ants and beetles to learn how they remember their way home

Cool This image is taken from United States Naval Medical Bulletin Vol. 13, Nos. 1-4, 1919 image

Check out this Camps Bay Beach image: This image is taken from United States Naval Medical Bulletin …

Read moreCool This image is taken from United States Naval Medical Bulletin Vol. 13, Nos. 1-4, 1919 image

About Alan

Previous Post:Supporting a child with long COVID – tips from parents of children living with the condition
Next Post:What does a conductor actually do? A surprising amount

Reach Trust

Reach Trust is a holding trust for a number of companies within the Stratlec Group.

Copyright © 2026 · Free-Mail · All Rights Reserved · Powered by Straton Electrical

Back to top