Repository navigation
[BUG] Documentation: TZ environment variable in docker compose seems to not work, APP_DISPLAY_TIMEZONE does #291
Description
Is there an existing issue for this?
- I have searched the existing issues
Current Behavior
When setting up a Bookstack docker image in docker compose i tried to change the timezone settings. In https://hub.docker.com/r/linuxserver/bookstack/ the variable TZ is shown. However this
bookstack:
image: lscr.io/linuxserver/bookstack:latest
environment:
TZ: Europe/Amsterdam
seems to have no effect, but using APP_DISPLAY_TIMEZONE does:
bookstack:
image: lscr.io/linuxserver/bookstack:latest
environment:
APP_DISPLAY_TIMEZONE: Europe/Amsterdam
However the docker hub documentation only mentions TZ, does not mention APP_TIMEZONE and APP_DISPLAY_TIMEZONE that are mentioned here: https://www.bookstackapp.com/docs/admin/language-config/
Expected Behavior
Assuming my use of TZ: Europe/Amsterdam was correct but the ENV variable doesn't do anything:
remove mentions of TZ, and replace with mention of APP_DISPLAY_TIMEZONE
Steps To Reproduce
- docker compose on linux, using bookstack latest image
- attempt to change the display timezone with TZ
- open bookstack and hover a timestamp, check to see which timezone is chosen for display
- change ENV variable to APP_DISPLAY_TIMEZONE
- open bookstack again, hover a timestamp and see that now it did take effect
Environment
- OS: CachyOS
- How docker service was installed: distro packagemanagerCPU architecture
x86-64
Docker creation
bookstack:
image: lscr.io/linuxserver/bookstack:latest
environment:
APP_DISPLAY_TIMEZONE: Europe/AmsterdamContainer 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: 33
User GID: 33
───────────────────────────────────────
Linuxserver.io version: v26.03.3-ls256
Build-date: 2026-04-13T19:21:12+00:00
───────────────────────────────────────
using keys found in /config/keys
Waiting for DB to be available
INFO Nothing to migrate.
[custom-init] No custom files found, skipping...
[ls.io-init] done.
Activity
[-][BUG] TZ environment variable in docker compose seems to not work, APP_DISPLAY_TIMEZONE does[/-][+][BUG] Documentation: TZ environment variable in docker compose seems to not work, APP_DISPLAY_TIMEZONE does[/+]github-actions commentedon Apr 18, 2026
Thanks for opening your first issue here! Be sure to follow the relevant issue templates, or risk having this issue marked as invalid.
aptalca commentedon Apr 18, 2026
Php has its own timezone setting which is only set during first run. If you want to change it later, you can edit the file php-local.ini in the config folder.
LinuxServer-CI commentedon May 18, 2026
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.
LinuxServer-CI commentedon Aug 18, 2026
This issue is locked due to inactivity