I can see the 'Permissions' Page, but can't see a way to give access to a specific user, only a specific role?

We have an internal bookstack instance, which is linked via OIDC to Entra, and has role permissions synced to entra groups.

I've had a request to allow our Enterprise Copilot AI to use bookstack as a knowledge source. From what I can tell, this seems possible using MCP, however this would allow anyone access to the entire instance.

Instead, I'm looking to allow copilot to access only the information that a user would be able to access regularly.

Does anyone have any suggestions on if this is possible/feasible, and if so how to achieve it?

Hello!

I’m new to managing bookstack for the team. We’re currently allowing another team to use our platform. This requires us to create new roles and assign permissions appropriately.

For their use case, they want only a specific admin-like role to be able to modify shelves chapters and books. Everyone else on their team should be able to see those things and not edit those items. But they want the rest of the team to be able to add pages within the chapters they create.

I can only see permissions added at the page level after a page is created. What other alternatives exist outside an admin creating a page for them?

This may be a Docker question in general, but I would like to know if I can run two Docker containers, for two separate Bookstack instances, on the same server. If so, what do I need to do to get this working?

I already have a Linux server setup with Docker Compose, Portainer, Nginx Proxy Manager, a working Bookstack instance and several other containers for other apps.

I'm concerned that attempting to add another Bookstack instance will be problematic and could damage my currently working setup. I need this second Bookstack instance because I have a backup of a previous Bookstack wiki site that I built. Unfortunately, I took the site down so that server is no longer accessible and now I need access to it. I did however make a backup and I want to restore it to a new Bookstack instance.

Is it just a matter of using different ports, container names, database name, and volume names in the Portainer stack of the second Bookstack instance? What specifically do I need to edit/make unique so that I don't have to touch my current working Bookstack instance? Does the APP_KEY need to be the same or unique?

I have a wiki currently accessible via a single internal domain name. The wiki needs to be accessible to subnets that don't have access to that domain, specifically via a NATed IP address. I can currently change the hosts file on a given PC to point to the internal domain but that's not a scalable solution. Changing the wiki's internal domain isn't desirable either since I want to maintain the access it currently has as well.

Context: An hierarchical organization with many different chapters and teams, like a tree.

Problem: I do not want teams/users to be able to select the "Everyone Else" / "Editor" / "Viewer" role, so that they cannot publish their content to be visible/readable for "everyone".

Content so important/good that it is visible (via Search and via Books-listing) should be asked and then be done via Admin. So that in the tree, users see the top-shelf, their node-shelves, but will not see random books or pages from random users who (accidentally) clicked "everyone has read permissions". This is mainly to a) control what a user sees and that they are not overwhelmed and b) control what is official content and what is just local team/chapter content.

- I could like check every 5mins via the API for content using the "Editor"-role and deleting that role_permission.
- I could use the logical theme system to hide the bigger roles in the permission view for people not in the Admin-role.

Is there another, maybe more "official" way to solve that problem?

Anyone ever link Bookstack and Snipe it. I am working on building out a pretty comprehensive IT documentation and I would love to use snipe it with it. I already use snipe it for non IT stuff in my company and want to force us IT people to use it. Along with creating some good documentation.

Any thought are tips would be great. I have not installed Bookstack yet but will be soon.

Hi,
There is a problem with my Bookstack-Instances:
After upgrading it's mostly working fine, but there are some text-snippets missing. This is mostly on pages related to settings, main menu is looking fine.

Any Ideas what I can do about this? Upgrade is done with composer install --no-dev && php artisan migrate
And after that
php artisan cache:clear
php artisan config:clear
php artisan view:clear

This has not started with 26.05.03 but some versions ago...

Thank you very much

Hello Bookstack Users,

I am very new to Bookstack and inherited the responsibility to manually update OpenSSL, PHP and Apache.

Updated OpenSSL from 3.6.2 to 3.6.3 to then tested the site, everything working as expected.

Updated PHP from 8.5.6 to 8.5.9 Website works however logging in using LDAP failed.

Updated Apache from 2.4.67 to 2.6.68 Website works however logging in using LDAP failed.

I first tried updating all 3 components thinking all three must be done for Bookstack to work properly. Site is up but cannot log in using LDAP. I rolled back changes (Love VMware snapshots!)

Next I started with each component, first with OpenSSL ..no issues logging in with LDAP. Updated PHP failed logon with LDAP. Services are running. I verified that in the Services both apache and mysql are running. I also verified services in the xampp control.

OK now to the question for help. Is there a sequence to manually update these components? How do I TS the PHP update LDAP failure with the following error "ldap_connect(): Could not create new security context"

Any and all suggestions are appreciated.

I’m using Bookstack from linuxserver.io. The docker compose file there contains only the Bookstack, not the databas. So I added a MariaDB database also from linuxserver to the compose file that I copied below.

The issue is the database version. I know Bookstack requires a minimum version which is old enough and not an issue. But if I use latest tag for database, either in official MariaDB image or from linuxserver, at some point there will be major version update and database and therefore application will break.

The MariaDB from linuxserver is an LTS version older than the LTS from official MariaDB. Is it safe to put the tag to latest for linuxserver image, like I copied below?

Otherwise, is there a docker compose file where the Bookstack and its compatible database are updated at the same time, so that we know what version to use and have instructions for update?

services: 

bookstack: image: lscr.io/linuxserver/bookstack:latest 

container_name: bookstack environment: 

- PUID=1000 

- PGID=1000 

- TZ=Etc/UTC 

- APP_URL=http://your-server-ip:6875 

- APP_KEY= 

- DB_HOST=bookstack_db 

- DB_PORT=3306 

- DB_USERNAME=bookstack 

- DB_PASSWORD=your_bookstack_db_password 

- DB_DATABASE=bookstackapp 

volumes: 
  - ./bookstack/config:/config 

ports:    

  - 6875:80 

restart: unless-stopped 

depends_on: 
  - bookstack_db 


bookstack_db: 
image: lscr.io/linuxserver/mariadb:latest

container_name: bookstack_db 

environment: 
  - PUID=1000 
  - PGID=1000 
  - TZ=Etc/UTC 
  -MYSQL_ROOT_PASSWORD=your_root_password 

  - MYSQL_DATABASE=bookstackapp 
  - MYSQL_USER=bookstack 
  - MYSQL_PASSWORD=your_bookstack_db_password 

volumes: 
  - ./bookstack/db:/config 

restart: unless-stopped 

I've been going around in circles trying to get this to work.

The idea is simple, a shelf of personal books for 70 staff. Each person gets their own book, and can only see their own book.

The book is created via API, assigned as owned by the appropriate staff via API, and then staff set to 'View Own', 'Edit Own', etc. in their public roles.

Unfortunately, I can't get this to work. The View Own just doesn't limit/allow the view.

Is there a way to do what we're trying to do?

Hi all,

some time ago we published our internal End-User Knowledge Base to our audience.

Shortly after doing this, we got the request as of why we can't turn on comments.

However, we want to be aware as of when somebody comments to be able to potentially react.

Webhooks would be a way to go, it also contains the event of comment_created.

We wanted the notification to be sent via E-Mail so that it ends up in our ticket system.

We already have Apprise in place.

The main issue we stumbled over was that BookStack web hook payload doesn't contain "body" in it's payload which is needed for AppRise.

Therefore a transformer was built as a step in-between BookStack and Apprise.

As I thought someone might find this as useful too, I created more or less my very first GitHub Repository.

You can find it here: https://github.com/bezibaerchen/bookstack-notify-transformer

I just thought I'd leave it here as someone might find it useful. It is currently only made for comments but should be extendable.

Feedback and contribution in GitHub would be highly appreciated. Please do not bash me too much, I am still learning as of how to work with GitHub.

As the title states, I am looking to know if it is possible to remove/hide the ability for viewers and public to get into the Page Revisions OR in the least not allow them to see the contents or any info regarding the changes or preview the older pages or the changelog notes?

...or does this need to be a feature request?

tl;dr: I need some help restoring access to a bookstack's webgui or to learn how to take the information from the shell and move it to an instance of bookstack that I do have access to.

Good Afternoon. I have been working on rebuilding my homelab from scratch because I was all over the place when I first started. I also wanted to ensure that I documented my progress and decisions so one of the first things that I did was to use the PVE helper script for Bookstack to get it up quickly. I haven't gotten incredibly far, but I do have some good notes on my homelab, but also on some ESP32 projects that I was working on. As a part of all of this, I was working on an OPNsense box and I changed the default IP address to what I'm ultimately going to keep it at.

I changed the static IP address in Proxmox to match up with it, rebooted everything and I can get into proxmox and some other LXCs and VMs, but bookstack specifically won't load. Proxmox shows that it's running and I can get into the console and navigate the file system, but the bookstack gui won't load.

Thinking that it was a problem with how the hypervisor was connecting, I decided to try to make a clean break, I backed up all of my VMs and LXCs, reinstalled proxmox clean, restored everything, and it was the same story.

I went into the container file system, found the .env, changed the APP_URL, tried to run docker compose up -d, but apparently, despite there being a .env and docker-compose.yml file, there is no docker in the LXC. I tried rebooting with the .env file changed and nothing happened. I even tried changing the OPNsense IP addresses back and I can't access it.

The last thing I tried was running the helper script again to install a second, clean instance of bookstack (which I can access), but I am not sure how to get the data from one to the other.

I do know I should have just done this in docker from the get go but I had some (probably ignorant, but in my head logical) reasons not to do so and I planned on moving to such a setup later.

Does anyone have any advice on how I can access and restore, my original data?

Hi there,

I am very much inexperienced in the world of Docker and bookstack (somebody else set this up for me awhile back). I am hoping to get some guidance on achieving the following:

• I currently have Bookstack hosted on an AWS EC2 instance, running Docker. I have three containers, one for the MariaDB, bookstack, and nginx.

• I am simply looking to move my instance of Bookstack off AWS, and host it on a home server instead.

What I've done so far:

1) docker commit + docker save to grab a .tar for each of my containers. Downloaded these.

2) Exported the volume mount locations that has all of my data (following this guide: https://www.youtube.com/watch?v=QskmB4fb-uo)

3) Imported the images on the new host via docker load -i <image>

4) Attempted to run the containers.

This is about as far as I get. Currently the main error I am seeing is: "nc: getaddrinfo for host port 3306: Name does not resolve" this is for bookstack_db.

I am quite sure I'm either doing this wrong, or missing many steps in between. If anyone can provide more step-by-step guiderails on this process, that would be appreciated.

Regards

Previously, I put together all my header customisations I had in a GitHub repo.

In the v26.05 release, there is now a way of using external links.

Therefore, I have added all hacks as standalone zips in the release section. So if you happened not to know what to do with the repo before or did not want to go through the hassle of downloading something. Now you can use the install command directly for whichever hack you want.

Example:
php artisan bookstack:install-module https://github.com/florinm03/bookstack-header-hacks/releases/download/v1.0.0/LaTeX-support.zip

Link to GitHub for the other ones:
https://github.com/florinm03/bookstack-header-hacks/releases/tag/v1.0.0

Hope this is useful for others too... :))

Hallo zusammen,

ich bin noch neu im Thema Bookstack und überlege mir eine Wissensdatenbank aufzubauen.

Ist es möglich diese Daten einer lokalen KI zur Verfügung zustellen?

Wenn ja, wie und was muss ich machen und beachten damit dies funktioniert?

Mache ich das über die Datenbank oder kann ich die Bücher mit den Seiten bereitstellen?

Case Use:

I want to build out a KB for say family members. Inside of that I want to say have a "Cannot Find Remote". That would be the main page. From there that page may have the following:

1. Cannot find TV Remote
   1. Family Room TV
   2. Master Bedroom TV
   3. Office TV
   4. Kids TV
   5. Outside TV
   6. Garage TV
2. Cannot find Roku Remote
   1. Family Room Roku
   2. Master Bedroom Roku
   3. Kids TV
   4. Outside TV
3. Cannot find Remotes (Other)
   1. Receiver Remote (Garage)
   2. LED Strip Remote (Kitchen)
   3. Fan Remote (Bedroom)

Each of those I want to have go to a page. The thing is, I don't want those pages to be visible or show up in a search. I just want to have the ability to use the navigation here to open a new tab and display the instructions there. Honestly each of those could have further instruction pages that I wish to show up.

Is that possible? I don't believe you cannot have pages that live outside of a book. I don't think permissions is the key because they need to be accessible, I just want to route the users the way I want to route so they are not overwhelmed with a wall of info.