linuxserver/docker-bookstack

[BUG] Nginx and php services do not start

BlueSwolenBallzZ opened this issue · 5 comments

Is there an existing issue for this?

  • I have searched the existing issues

Current Behavior

When running the LinuxServer.io BookStack Docker container on Unraid using a macvlan network (br0) with a static IP, the container fails to function properly:

  1. The container starts, but nginx is not running (ps aux | grep nginx shows no active process).
  2. PHP-FPM is missing, although it is required for BookStack (which php-fpm returns command not found).
  3. A 502 Bad Gateway error appears when trying to access BookStack in the browser, indicating that nginx cannot reach PHP-FPM.
  4. Logs do not show any critical errors, but BookStack fails to initialize correctly.
  5. The container receives the correct IP address from the br0 network (network from my rounter), but remains inaccessible.
  6. I can ping the IP adress successfully.
  7. Before trying to install the services manually i was unable to connect. (ports correct)
  8. Even after setting the KEY, nothing changed.

Expected Behavior

  • The BookStack container should fully start and be accessible at http://192.168.100.177.
  • nginx and PHP-FPM should be running automatically inside the container.
  • BookStack should initialize correctly and display the web interface instead of a 502 error.

Steps To Reproduce

  • Install the LinuxServer.io BookStack container on Unraid (7.0.1).
  • Configure the container to use a static IP on the custom macvlan network (192.168.XXX.XXX).
  • Start the container via Unraid UI or docker-compose.
  • Attempt to access http://192.168.XXX.XXX in a browser.
  • Observe the 502 Bad Gateway error.

Environment

OS: Unraid 7.0.1
Docker Installation: Pre-installed Unraid Docker service
CPU Architecture: x86_64

CPU architecture

x86-64

Docker creation

Used the Unraid UI

Container logs

root@HomeLAB:~# docker logs bookstack --tail 50
[migrations] started
[migrations] 01-nginx-site-configs-default: skipped
[migrations] 02-default-location: skipped
[migrations] done

    LSIO
Brought to you by linuxserver.io

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

-------------------------------------
        GID/UID
-------------------------------------

User UID:    99
User GID:    100

-------------------------------------
Linuxserver.io version: v25.02.1-ls198
Build-date: 2025-03-17T18:31:08+00:00

using keys found in /config/keys
The application key is missing, halting init!
You can generate a key with: docker run -it --rm --entrypoint /bin/bash lscr.io/linuxserver/bookstack:latest appkey
And apply it to the APP_KEY environment variable.

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

Did you do what it tells you to do in the logs?

The log tells you why
halting init!

This issue has been automatically marked as stale because it has not had recent activity. This might be due to missing feedback from OP. It will be closed if no further activity occurs. Thank you for your contributions.

This issue is locked due to inactivity