Using BookStack as a Linux File System

Dan Brown posted on the 20th of April 2025

For a while I’ve been playing with the idea of being able to mount a BookStack instance as a Linux file system. I attempted this a while ago, but recently dedicated a day to finishing up a proof on concept for this. The resulting project, with usage details, can be found here on Codeberg:

https://codeberg.org/bookstack/filesystem

This little application mounts a FUSE-based linux file system which in the background reads books, chapters and pages from BookStack over the API, to present the content as a read-only series of folders and files. Files are essentially the page content provided via the export API endpoints. By default they are plain text export files, but there’s an option to alternatively use PDF, HTML or Markdown exports for page files.

This is only a simple proof of concept application written in Go, and is not really meant for production use since there will be limitations and bugs, but it’s a fun idea which may be useful to others. The code (linked above) is all open source and open to further hackery where desired.

For a full visual demo I’ve put together a quick video of this in use:

Header Image Credits:  Photo by Dietmar Rabich (CC-BY-SA-4) - Image Modified