The example docker-compose.yml uses a bind mount for the MariaDB data directory:

services:
  mariadb:
    volumes:
      # You generally only ever need to map this one volume.
      # This maps it to a "bookstack_db_data" folder in the same
      # directory as this compose config file.
      - ./bookstack_db_data:/config

On Windows, this bind-mount path resolves to a case-insensitive filesystem (NTFS). MariaDB detects this at startup and automatically forces lower_case_table_names=2, logging:

[Warning] Setting lower_case_table_names=2 because file system for /config/databases/ is case insensitive

This cannot be overridden via my.cnf — MariaDB ignores the setting when its filesystem detection takes precedence.

lower_case_table_names=2 is a partially broken mode. InnoDB's TRUNCATE TABLE implementation internally tries to rename the .ibd tablespace file, which fails under this mode, producing:

[ERROR] InnoDB: Cannot rename './bookstack/joint_permissions.ibd' to
'./bookstack/#sql-ib70.ibd' because the source file does not exist.

This causes BookStack's migration 2023_01_24_104625_refactor_joint_permissions_storage to fail with:

SQLSTATE[HY000]: General error: 1030 Got error 194 "Tablespace is missing for a table"
SQL: truncate table `joint_permissions`

BookStack becomes unreachable on every fresh install on Windows. The error is not obvious — the containers appear to start successfully. Only after the first login you will see an "Unknown Error" page.

Fix

Replace the MariaDB bind mount with a named Docker volume. Docker named volumes reside on the Linux VM filesystem inside Docker Desktop's WSL2 backend, which is case-sensitive. MariaDB initialises correctly and migrations complete without error.

services:
  mariadb:
    volumes:
      - bookstack_db_data:/config   # named volume, not a host path

volumes:
  bookstack_db_data:

Suggested documentation changes

Add a callout/warning in the comments along the lines of:

Windows users: Do not bind-mount the MariaDB data directory to a Windows host path (e.g. ./bookstack_db_data:/config). Use a named Docker volume instead. Bind-mounting to a Windows filesystem forces MariaDB into lower_case_table_names=2 mode, which causes InnoDB errors and breaks database migrations.

Tested with

AI Disclaimer: The analysis and description of this issue were developed with the assistance of an AI tool (GitHub Copilot). However, the issue itself is real and was encountered and verified by me on an actual Windows installation. The root cause, error messages, and fix have all been confirmed through hands-on testing.

Introduce a renderQueue promise chain so that concurrent mermaid.run()
calls are executed sequentially, preventing race conditions when multiple
diagrams are initialized at the same time. Also add missing newline at
end of file.