From 6c8b29f3264074712e51a08edbb252bbf9803c57 Mon Sep 17 00:00:00 2001 From: Jonathan Jogenfors Date: Thu, 16 Mar 2023 18:19:35 +0100 Subject: [PATCH] Document fallback timezone setting (fixes #2000) (#2003) * Update FAQ.md * Fix typo * Mention the extract metadata job * Don't duplicate code --- docs/docs/FAQ.md | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) diff --git a/docs/docs/FAQ.md b/docs/docs/FAQ.md index 457cea534f..89497e5ff4 100644 --- a/docs/docs/FAQ.md +++ b/docs/docs/FAQ.md @@ -16,10 +16,19 @@ sidebar_position: 7 Immich doesn't have the mechanism to sync an existing directory with the server. There is however, a helper CLI tool to help you bulk upload the existing photos and videos to the server. You can find the guide to use the CLI tool [here](/docs/features/bulk-upload.md). -### Why does my uploaded photo show up with the wrong date in Immich? +### Why does my uploaded photo show up with the wrong date or time in Immich? When a photo is initially uploaded Immich uses the create date of the file to determine where it belongs in the timeline. After that, background jobs will run that extract [exif metadata](https://en.wikipedia.org/wiki/Exif), including the CreateDate, to provide a more accurate date for the photo. If that is not available it will fallback to the modified date. If you want to ensure your photo has the right date, check the exif metadata before uploading. +If the timezone is incorrect in an uploaded photo, check the ``DateTimeOriginal`` exif field of the uploaded file. Immich uses the very competent library [exiftool-vendored.js](https://github.com/photostructure/exiftool-vendored.js#dates) to handle timezone parsing, but in some cases (like photos taken with DSLR cameras) it has to fallback on the local timezone. If you are using docker, this fallback will be UTC. (Note that even the photo backup app that can't be named [has the same bug!](https://photo.stackexchange.com/a/126978)) In Immich, it is possible to change this assumed fallback timezone system-wide by setting the timezone in the microservices docker container. You might need to run the "Extract Metadata" job after to effect the change. + +As an example, the following modification of ```docker-compose.yml``` will set the timezone of the microservices container to be ``Europe/Stockholm`` + +``` + environment: + - TZ=Europe/Stockholm # <---- Add this line in the microservices config +``` + ### Why doesn't Immich watch an existing photo gallery directory? The initial approach of Immich is to become a backup tool, primarily for mobile device usage. Thus, all the assets must be uploaded from the mobile client. The app was architectured to perform that job well.