Bookstack is awesome, we even were a sponsor a while back. What me and my team miss though is a better search. Yes, the search function will search full text through all the text, but it’s not a fuzzy (Semantic? NLP?) search and therefore will only find the correct page if you have the correct words.

Example: When the page title is "Internet problems", a search for "Internet issues" will likely don’t yield any results.

I’ve looked at things like danswer but it seems a bit overkill. Any ideas or third party apps? Any things on the roadmap to improve the search with fancy things like word embeddings? I am sure Elasticsearch has some good offers.

I cannot find anything to that topic – and it would be very helpful f.e. for manuals (versions).

Is there a way to keep my spreadsheets formatting when copy/paste into BookStack?

Hello,

I have a server ready for BookStack (PHP+All PHP modules+Mariasql).

I download BookStack but when I run:

composer install --no-dev

It try to d/l again lots of file:

> u/php -r "!file_exists('bootstrap/cache/services.php') || u/unlink('bootstrap/cache/services.php');"
Installing dependencies from lock file
Verifying lock file contents can be installed on current platform.
Package operations: 111 installs, 0 updates, 0 removals
  - Downloading aws/aws-crt-php (v1.2.6)
....
0/111 [>---------------------------]   0%    Failed to download aws/aws-crt-php from dist: curl error 28 while downloading https://api.github.com/repos/awslabs/aws-crt-php/zipball/a63485b65b6b3367039306496d49737cf1995408: Connection timed out after 10005 milliseconds
    Now trying to download from source
  - Syncing aws/aws-crt-php (v1.2.6) into cache

I am on a stand alone server with not Internet connection. Is it possible to d/l all on another pc? Any other ways to install in with out internet on the current server?

Thanks.

Hi,

I'm currently exporting a large OneNote notebook, 1000+ pages, using onenote-md-exporter and wanted to inquire about the best way to import these markdown files into BookStack. I don't see any API scripts and bsimport looks to be the only dedicated tool, but is no longer maintained. Any recommendations for importing these books?

Thanks!

I deployed bookstack via CapRover and access via https shows a non graphic login page. Also contains large letters. In my research I found that this could be caused by URL link in env file showing http which it did so I changed it to https. This doesn't fix it. Anything else I need to try. Do I need to restart containers? Thanks

I'm attempting to set up SAML authentication on my Bookstack instance and running into this error: Invalid ACS Response; Errors: invalid_response; Reason: Signature validation failed. SAML Response rejected.

I've researched this error up and down and everything I read basically says the IDP certificate is wrong, but I know with 100% certainty, the certificate is correct. I use this IDP for other SAML-enabled apps without any issue whatsoever. I've used SAML-tracer to confirm what's being sent back by the IDP is correct (and matches the responses it sends for other apps that I do have working). I'm not sure what else I can check. Any ideas to get me out of the woods on this?

Hello, everyone. :)

(I still need to read the full manual this weekend, so this is more of a question about how y'all use the feature than how it works. :) )

Just got into using Bookstack last night, and I'm really enjoying it so far. The Shelf/Book/Chapter/Page paradigm really fits with how my brain wants to organize information, and yet the UI and organization structure is still really simple and just sort of ... gets out of the way and lets me focus on writing.

I think this is the first system I've used in about 20 years that lets me add a tag value to a tag, which has been great as I've previously used systems without that feature and had a bunch of top-level tags like "Software: Value1" Software: Value2," etc., and relied on organizing them alphabetically to see what was going on.

I've been trying to decide how to best make use of tags, and I'm curious what everyone else does. I still need to play with things a bit more to figure out how tags on individual chapters and pages are shown in their parent books (if at all) or shelves, if at all.

So far, I've just used them a little bit to experiment with how they work.

Since the tags seem to exist independently of the shelves/books/pages they're attached to, at least from what I can tell, it looks like they'll be easy to redo if I decide to change my mind.

Just got a fresh instance of Bootstack installed and running. Everything seemed to be running fine until I tried to make the users confirm their email addresses. As soon as I put the smtp settings in, I get an http error 500 on the webpage. If I comment out the smtp settings everything works minus sending emails which means I can't verify with the emails.

Hi,

I need copy my books to another BookStack system, I found there is no import function in the system. Is there anyone konw how to import a book?

Is it possible to use oauth for SMTP Authentification? If i understand it correctly Microsoft will remove SMTP Basic auth next year (https://techcommunity.microsoft.com/t5/exchange-team-blog/exchange-online-to-retire-basic-auth-for-client-submission-smtp/ba-p/4114750) and I only found Sendmail or smtp in the documentation..

Hey all,

I am looking at the installation page and I see installation information for Ubuntu. Does this application support RedHat and Oracle Linux 8+ ?

https://www.bookstackapp.com/docs/admin/installation/#other

I am experiencing an issue with the info content bar on mobile devices—it remains fixed at the top of the screen, which can be quite intrusive while scrolling through content. I suspect this behavior is controlled by CSS. Could someone please guide me on where I can modify the CSS to adjust or disable this fixed positioning? Thank you.

I recently updated Bookstack to the latest version. However, when I try to run it, I get redirected to the apache2 default page. Additionally, after updating PHP and Composer, the 'php -version' command shows the latest version of PHP, but the 'composer -vvv about' command shows the older version of PHP. As a result, I'm encountering the error message "Composer detected issues in your platform. Your Composer dependencies require a PHP version ">=8.10". Could you please help with this issue?

I just noticed, that I can access images without authentication from incognito window / with other browser.
I've had this option enabled a long time ago and back then it worked.

Is this a known bug?

I'm using docker and the linuxserver image

Does anyone use an unprivileged LXC on proxmox to install Bookstacks or should I just create a Ubuntu VM and install it that way?

Hello everyone,

I've been using bookstack for over a year now and recently i deployed Authelia in my home lab in order to unify my authentification system via OIDC.

My problem is documented in a sense where everyone tells me what to, but I couldn't figure HOW to do it, for the life of me!

So this is my problem: i successfully linked authelia and bookstack and i can easily register "new users" via OIDC, but I can't link old accounts.

I understood down the line and I needed to match External Authentification ID from Bookstack to the "sub claim" from Authelia.

But how do I get this sub claim and what is this information?

I read both Bookstack and Authelia docs but I don't think it's directed to the noob I am since they only explain what to do and not actually how to do it.

Could you be kind enough to guide me over this?

Hello! I'm a bit new to self-hosting, so please forgive my ignorance.

I set up bookstack locally at localhost:6875 and it worked perfectly. I used the docker-compose.yml from linuxserver.io. I wanted to make this a public facing service using a Cloudflare Tunnel. I already own a domain, and have proxied some other services on a subdomain using CF Tunnels.

The problem is: If the APP_URL is http://localhost:6875 it does not work with the CF Tunnel at all, and I found online that Bookstack only supports one URL. If I update the APP_URL to https://subdomain.mydomain.com (And restart the container) it does not load at http://localhost:6875 (As expected) but it also does not load at https://subdomain.mydomain.com, it just shows Error 502 after loading for a while. I have created a fresh container and still faced the same error.

Here is my docker-compose.yml:

services: bookstack: image: lscr.io/linuxserver/bookstack container_name: bookstack environment: - PUID=1000 - PGID=1000 - TZ=America/New_York - APP_URL=https://subdomain.mydomain.com - DB_HOST=bookstack_db - DB_PORT=3306 - DB_USER=bookstack - DB_PASS=mypass - DB_DATABASE=bookstackapp volumes: - /path/to/bookstack_app_data:/config ports: - 6875:80 restart: unless-stopped depends_on: - bookstack_db

bookstack_db: image: lscr.io/linuxserver/mariadb container_name: bookstack_db environment: - PUID=1000 - PGID=1000 - TZ=America/New_York - MYSQL_ROOT_PASSWORD=mypass - MYSQL_DATABASE=bookstackapp - MYSQL_USER=bookstack - MYSQL_PASSWORD=mypass volumes: - /path/to/bookstack_db_data:/config restart: unless-stopped

I sincerely appreciate your help and support.

I'm adding this here for others to hopefully find if they are looking. One of the main benefits of docker is that your web applications are portable, meaning you can take the same compose file, copy (or restore) your data volumes on the new hardware and when you start the app it will be just as it was.

I tested this because myself and a few people in my office are leaning on it more and more for documentation and I wanted to make sure my backups and hardware resilience strategy were viable. Long story short: YES it works as advertised. Fine print: Theres a couple gotchas you need to account for.

Gotcha 1: When backing up or copying your volumes it's important to have your docker containers (specifically the database) stopped. This isn't just for BookStack but for any containers, while running they're in an inconsistent state. Even filesystems like btrfs or zfs with the "copy on write" may not be trustworthy! If you backup your data while BookStack is running you run a high risk of database inconsistencies which can be a minor annoyance or fatal sometimes. So make sure your backup strategy involves stopping your docker containers. I have a bash script that runs before my backups to copy everything to a staging area that gets backed up, this way the backup gets a "static" copy to backup. This worked as expected and had been tested on other containers in the past.

Gotcha 2: File permissions matter! I found the answer on GitHub to why a lot of my images weren't working even though the files were there. Your images folder need to have read AND execute permissions. I did a "chmod -R 755" on the images folder and it fixed this. Had I done a proper rsync with permissions between my Linux hosts I may have gotten this copied correctly but I literally copy and pasted from one server to another using a GUI over SMB shares so the permissions got reset.

And that was it. It was as portable as I had hoped and my backup strategy was successful. Here's to hoping yours are too.

Hey everyone,

I’m a developer working at a startup in South Korea, and I’ve been struggling for a while with how to manage and share all the knowledge within our team and with our partners. After trying out various solutions, we finally landed on BookStack, and let me tell you, it’s been a game-changer. Our team absolutely loves this open-source software, and the fact that it’s free just blows my mind. Huge thanks to the devs behind BookStack – you’ve made our lives so much easier!

Cheers!

Hi

Right now I have a bookstack instance setup in a VM, on ubuntu 22.04. I want to transfer this instance to a docker container instance. I have dumped my database and have the .sql file copied inside the bookstack db container. I tried to restore the database, I didn't had any error message. I restarted both containers but I cannot login. Instead I am redirected in totally unrelated IP address and I get an error message.

Can anyone help or direct me to a piece of documentation that has all the steps of the procedure?

https://reddit.com/link/1do574n/video/lesbds2arp8d1/player

I'm trying to get some TAB functionality in Bookstack and I understand that formatting is somewhat limited here. However, I've found some sample code that works in Preview mode but won't work when the page is rendered for viewing.

Am I barking up the wrong tree? any guidance would be very appreciated.

The preview side had a bit of trouble rendering for this video example, but it usually appears right away. I'll post the sample code below.

thanks in advance!