Docker compose: TZ variable documented in .env file, yet not used in compose file #8418

Closed
opened 2026-02-05 13:43:56 +03:00 by OVERLORD · 3 comments
Owner

Originally created by @XobSod on GitHub (Feb 3, 2026).

I have searched the existing issues, both open and closed, to make sure this is not a duplicate report.

  • Yes

The bug

The documentation of Docker Compose deployment mentions an .env file that has TZ commented out

Image

But following the suggestion and uncommenting the line doesn't do anything as the TZ variable is not referenced in the compose file.

Is it an oversight (and I can add environment variable to reference and set TZ in containers) or is it by design (and it is not safe to set TZ in containers)?

The OS that Immich Server is running on

Ubuntu 22

Version of Immich Server

v2.5.2

Version of Immich Mobile App

v2.5.2

Platform with the issue

  • Server
  • Web
  • Mobile

Device make and model

No response

Your docker-compose.yml content

https://github.com/immich-app/immich/releases/latest/download/docker-compose.yml

Your .env content

https://github.com/immich-app/immich/releases/latest/download/example.env

Reproduction steps

N/A

Relevant log output


Additional information

No response

Originally created by @XobSod on GitHub (Feb 3, 2026). ### I have searched the existing issues, both open and closed, to make sure this is not a duplicate report. - [x] Yes ### The bug The documentation of Docker Compose deployment mentions an .env file that has TZ commented out <img width="692" height="350" alt="Image" src="https://github.com/user-attachments/assets/b1a00068-6d9a-4a5e-9833-cfe0a2a25bf4" /> But following the suggestion and uncommenting the line doesn't do anything as the TZ variable is not referenced in the compose file. Is it an oversight (and I can add environment variable to reference and set TZ in containers) or is it by design (and it is not safe to set TZ in containers)? ### The OS that Immich Server is running on Ubuntu 22 ### Version of Immich Server v2.5.2 ### Version of Immich Mobile App v2.5.2 ### Platform with the issue - [x] Server - [ ] Web - [ ] Mobile ### Device make and model _No response_ ### Your docker-compose.yml content ```YAML https://github.com/immich-app/immich/releases/latest/download/docker-compose.yml ``` ### Your .env content ```Shell https://github.com/immich-app/immich/releases/latest/download/example.env ``` ### Reproduction steps N/A ### Relevant log output ```shell ``` ### Additional information _No response_
Author
Owner

@mmomjian commented on GitHub (Feb 3, 2026):

The env file is passed into the container with the env_file directive.

@mmomjian commented on GitHub (Feb 3, 2026): The env file is passed into the container with the env_file directive.
Author
Owner

@XobSod commented on GitHub (Feb 3, 2026):

Not to all of them tho... This makes immich-server and immich-machine-learning running possibly in different time zones than redis and database @mmomjian

@XobSod commented on GitHub (Feb 3, 2026): Not to all of them tho... This makes `immich-server` and `immich-machine-learning` running possibly in different time zones than `redis` and `database` @mmomjian
Author
Owner

@mmomjian commented on GitHub (Feb 3, 2026):

Those containers do not need a timezone.

@mmomjian commented on GitHub (Feb 3, 2026): Those containers do not need a timezone.
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: immich-app/immich#8418