Bookstack is unable to connect to MariaDB #5467

Closed
opened 2026-02-05 10:05:16 +03:00 by OVERLORD · 6 comments
Owner

Originally created by @wachtell on GitHub (Oct 23, 2025).

Describe the Bug

Suddenly the bookstack-mariadb-0 container stopped working is giving this error:
kubectl logs bookstack-mariadb-0
Defaulted container "mariadb" out of: mariadb, preserve-logs-symlinks (init)
Error from server (BadRequest): container "mariadb" in pod "bookstack-mariadb-0" is waiting to start: PodInitializing

Steps to Reproduce

Error: kubectl logs bookstack-mariadb-0
Defaulted container "mariadb" out of: mariadb, preserve-logs-symlinks (init)
Error from server (BadRequest): container "mariadb" in pod "bookstack-mariadb-0" is waiting to start: PodInitializing

Expected Behaviour

That the bookstack server would connect to the database.

Screenshots or Additional Context

No response

Browser Details

Firefox Windows 11

Exact BookStack Version

BookStack v25.07.3

Originally created by @wachtell on GitHub (Oct 23, 2025). ### Describe the Bug Suddenly the bookstack-mariadb-0 container stopped working is giving this error: kubectl logs bookstack-mariadb-0 Defaulted container "mariadb" out of: mariadb, preserve-logs-symlinks (init) Error from server (BadRequest): container "mariadb" in pod "bookstack-mariadb-0" is waiting to start: PodInitializing ### Steps to Reproduce Error: kubectl logs bookstack-mariadb-0 Defaulted container "mariadb" out of: mariadb, preserve-logs-symlinks (init) Error from server (BadRequest): container "mariadb" in pod "bookstack-mariadb-0" is waiting to start: PodInitializing ### Expected Behaviour That the bookstack server would connect to the database. ### Screenshots or Additional Context _No response_ ### Browser Details Firefox Windows 11 ### Exact BookStack Version BookStack v25.07.3
OVERLORD added the 🐕 Support label 2026-02-05 10:05:16 +03:00
Author
Owner

@ssddanbrown commented on GitHub (Oct 23, 2025):

Hi @wachtell,
This'll be quite setup/environment dependant, so can you detail your environment. What containers are you using? What host OS/service are you using? Can you provide any config/commands you're using? etc...

@ssddanbrown commented on GitHub (Oct 23, 2025): Hi @wachtell, This'll be quite setup/environment dependant, so can you detail your environment. What containers are you using? What host OS/service are you using? Can you provide any config/commands you're using? etc...
Author
Owner

@wachtell commented on GitHub (Oct 24, 2025):

@ssddanbrown Thank you for reaching out. Bookstack is set up in Kubernetes on an Ubuntu 24.04 cluster using Helm.

@wachtell commented on GitHub (Oct 24, 2025): @ssddanbrown Thank you for reaching out. Bookstack is set up in Kubernetes on an Ubuntu 24.04 cluster using Helm.
Author
Owner

@ssddanbrown commented on GitHub (Oct 24, 2025):

  • What containers are you using?
  • Can you provide any config/commands you're using?
  • Does this always happen if you re-init the stack?
  • Are you able to get any logs from the mariadb container from when it's starting up?
@ssddanbrown commented on GitHub (Oct 24, 2025): - What containers are you using? - Can you provide any config/commands you're using? - Does this always happen if you re-init the stack? - Are you able to get any logs from the mariadb container from when it's starting up?
Author
Owner

@wachtell commented on GitHub (Oct 27, 2025):

Bookstack:
 ghcr.io/linuxserver/bookstack:version-v25.07.3
Database container:
bitnami/mariadb:11.4.4-debian-12-r0

Yes, it happens when I re-init the stack.
The logs I get:
kubectl logs bookstack-mariadb-0
Defaulted container "mariadb" out of: mariadb, preserve-logs-symlinks (init)
Error from server (BadRequest): container "mariadb" in pod "bookstack-mariadb-0" is waiting to start: PodInitializing

Do you think the container is corrupted?

@wachtell commented on GitHub (Oct 27, 2025): Bookstack:  ghcr.io/linuxserver/bookstack:version-v25.07.3 Database container: bitnami/mariadb:11.4.4-debian-12-r0 Yes, it happens when I re-init the stack. The logs I get: kubectl logs bookstack-mariadb-0 Defaulted container "mariadb" out of: mariadb, preserve-logs-symlinks (init) Error from server (BadRequest): container "mariadb" in pod "bookstack-mariadb-0" is waiting to start: PodInitializing Do you think the container is corrupted?
Author
Owner

@ssddanbrown commented on GitHub (Oct 28, 2025):

It's hard to determine what's going on as there's no application/container specific information with that provided error message at all, it's just information at the K8s layer.

You could try ensuring containers are stopped, then take a copy the mariadb container volume data, then attempt to use that via a standard docker run command using the exact same container image version.
That can confirm if the data is okay, or help provide more detailed errors in its logs.

Of course, ensure everything is backed up before attempting anything.

@ssddanbrown commented on GitHub (Oct 28, 2025): It's hard to determine what's going on as there's no application/container specific information with that provided error message at all, it's just information at the K8s layer. You could try ensuring containers are stopped, then take a copy the mariadb container volume data, then attempt to use that via a standard docker run command using the exact same container image version. That can confirm if the data is okay, or help provide more detailed errors in its logs. Of course, ensure everything is backed up before attempting anything.
Author
Owner

@wachtell commented on GitHub (Nov 12, 2025):

@ssddanbrown Thank you for reaching out to me. After researching, I realized that the reason the mariaDB did not initialize was that Helm calls bitnami/mariaDB. However, bitnami/mariaDB has since late September gone into legacy and is replaced by bitnamisecure/mariaDB. Once I replaced the image, everything worked fine. Go figure :-)

@wachtell commented on GitHub (Nov 12, 2025): @ssddanbrown Thank you for reaching out to me. After researching, I realized that the reason the mariaDB did not initialize was that Helm calls bitnami/mariaDB. However, bitnami/mariaDB has since late September gone into legacy and is replaced by [bitnamisecure/mariaDB.](https://hub.docker.com/r/bitnamisecure/mariadb) Once I replaced the image, everything worked fine. Go figure :-)
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: starred/BookStack#5467