Open
Description
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:
- The container starts, but nginx is not running (ps aux | grep nginx shows no active process).
- PHP-FPM is missing, although it is required for BookStack (which php-fpm returns command not found).
- A 502 Bad Gateway error appears when trying to access BookStack in the browser, indicating that nginx cannot reach PHP-FPM.
- Logs do not show any critical errors, but BookStack fails to initialize correctly.
- The container receives the correct IP address from the br0 network (network from my rounter), but remains inaccessible.
- I can ping the IP adress successfully.
- Before trying to install the services manually i was unable to connect. (ports correct)
- 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.
Metadata
Metadata
Assignees
Type
Projects
Status
Issues