[BUG] No Books can be opend: An Error Occurred: /app/www/storage/framework/purifier not writable

[stodo94]

Is there an existing issue for this?

• I have searched the existing issues

Current Behavior

No Books can be opend:

Error in laravel.log:
production.ERROR: Directory /app/www/storage/framework/purifier not writable, please alter file permissions (View: /app/www/resources/views/books/show.blade.php) {"userId":1,"exception":"[object] (Illuminate\View\ViewException(code: 0): Directory /app/www/storage/framework/purifier not writable, please alter file permissions (View: /app/www/resources/views/books/show.blade.php) at /app/www/vendor/ezyang/htmlpurifier/library/HTMLPurifier/DefinitionCache/Serializer.php:303)

after changing permissions to 777 on directory /app/www/storage/framework/purifier sites works as expected.

After Container recreation error come back again

Expected Behavior

Books should be readable and editable

Steps To Reproduce

1. Login works perfectly
2. 2fa is working perfectly
3. Books are listed normaly
4. Open Book will show the error

Environment

- OS: Debian 13
- How docker service was installed:

CPU architecture

x86-64

Docker creation

services:
  bookstack:
    image: lscr.io/linuxserver/bookstack
    container_name: bookstack
    environment:
      - PUID=1000
      - PGID=1000
      - APP_URL=********
      - APP_PROXIES=*********
      - TZ=Europe/Berlin
      - DB_HOST=bookstack_db
      - DB_PORT=3306
      - DB_USERNAME=bookstack
      - DB_PASSWORD=**********
      - DB_DATABASE=bookstackapp
    volumes:
      - vol_bookstack_data:/config
    ports: []
    restart: unless-stopped
    depends_on:
      - bookstack_db
    networks:
      net_wiki:
        ipv4_address: **********
  bookstack_db:
    image: lscr.io/linuxserver/mariadb:latest
    container_name: bookstack_db
    environment:
      - PUID=1000
      - PGID=1000
      - MYSQL_ROOT_PASSWORD=*************
      - TZ=Europe/Berlin
      - MYSQL_DATABASE=bookstackapp
      - MYSQL_USER=bookstack
      - MYSQL_PASSWORD=*************
    volumes:
      - vol_bookstack_db:/config
    networks:
      net_wiki:
        ipv4_address: ************
    restart: unless-stopped
networks:
  net_wiki:
    external: true
volumes:
  vol_bookstack_data:
    external: true
  vol_bookstack_db:
    external: true

Container logs

[migrations] started
[migrations] 01-nginx-site-confs-default: skipped
[migrations] 02-default-location: skipped
[migrations] done
───────────────────────────────────────

      ██╗     ███████╗██╗ ██████╗
      ██║     ██╔════╝██║██╔═══██╗
      ██║     ███████╗██║██║   ██║
      ██║     ╚════██║██║██║   ██║
      ███████╗███████║██║╚██████╔╝
      ╚══════╝╚══════╝╚═╝ ╚═════╝

   Brought to you by linuxserver.io
───────────────────────────────────────

To support LSIO projects visit:
https://www.linuxserver.io/donate/

───────────────────────────────────────
GID/UID
───────────────────────────────────────

User UID:    1000
User GID:    1000
───────────────────────────────────────
Linuxserver.io version: v25.12.4-ls245
Build-date: 2026-02-17T11:59:27+00:00
───────────────────────────────────────

using keys found in /config/keys
**** The following active confs have different version dates than the samples that are shipped. ****
**** This may be due to user customization or an update to the samples. ****
**** You should compare the following files to the samples in the same folder and update them. ****
**** Use the link at the top of the file to view the changelog. ****
┌────────────┬────────────┬────────────────────────────────────────────────────────────────────────┐
│  old date  │  new date  │ path                                                                   │
├────────────┼────────────┼────────────────────────────────────────────────────────────────────────┤
│ 2023-04-13 │ 2025-12-26 │ /config/nginx/nginx.conf                                               │
│ 2023-04-13 │ 2025-12-26 │ /config/nginx/site-confs/default.conf                                  │
│ 2023-06-24 │ 2025-12-26 │ /config/nginx/ssl.conf                                                 │
└────────────┴────────────┴────────────────────────────────────────────────────────────────────────┘
Waiting for DB to be available

   INFO  Nothing to migrate.

[custom-init] No custom files found, skipping...
[ls.io-init] done.

[github-actions]

Thanks for opening your first issue here! Be sure to follow the relevant issue templates, or risk having this issue marked as invalid.

[stodo94]

Docker was Installed with this commands:
apt-get install ca-certificates curl gnupg
install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/debian/gpg | gpg --dearmor -o /etc/apt/keyrings/docker.gpg
chmod a+r /etc/apt/keyrings/docker.gpg
echo
"deb [arch="$(dpkg --print-architecture)" signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/debian
"$(. /etc/os-release && echo "$VERSION_CODENAME")" stable" |
tee /etc/apt/sources.list.d/docker.list > /dev/null
apt-get update

apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

usermod -aG docker "myuser"

[bughidudi]

same issue here, reverting to v25.12.3-ls244 fixed it

[stodo94]

Reverting to v25.12.3 also fixed it for me... hopefully a fix will be published the next days

[HeMaN-NL]

same here:
Directory /app/www/storage/framework/purifier not writable

I tried with a woraround and can confirm that after it is read write again it is working as it is supposed to.

• in my docker-compose.yml I mounted a custom-cont-init.d/ with a script 20-fix-bookstack-perms.sh

    volumes:
      - ./config/scripts/custom-cont-init.d:/custom-cont-init.d:ro

# 20-fix-bookstack-perms.sh

#!/usr/bin/with-contenv bash
set -euo pipefail

APP_STORAGE=/app/www/storage
PURIFIER_DIR="$APP_STORAGE/framework/purifier"

mkdir -p "$PURIFIER_DIR"
chown -R abc:abc "$APP_STORAGE"
chmod -R u+rwX,g+rwX "$APP_STORAGE"

[thespad]

Resolved in #284

[ssddanbrown]

Sorry for this, it was totally an oversight on my part to introduce a new storage folder which caused issues much wider than just this container setup. I just pushed a new released which instead uses existing folders: https://github.com/BookStackApp/BookStack/releases/tag/v25.12.5

Sorry that this led to changes & time consumed by the LSIO team ❤️

[HeMaN-NL]

Confirmed working for me. Thnx!