High performance self-hosted photo and video management solution.
TypeScript backup-toolfluttergoogle-photosgoogle-photos-alternativejavascriptmobile-appnestjsnodejsphoto-galleryphotosphotos-managementself-hostedsveltesveltekittypescriptvideos
docs: external library deletion/edits (#12079)
Matthew Momjian16d5996f773e
diff --git a/docs/docs/FAQ.mdx b/docs/docs/FAQ.mdxindex a5d9b6e3d3..501a67d5f2 100644--- a/docs/docs/FAQ.mdx+++ b/docs/docs/FAQ.mdx@@ -63,8 +63,9 @@ We recommend using a real SSL certificate from a free provider, for example [Let### Does Immich change the file?-No, Immich does not touch the original file under any circumstances,-all edited metadata are saved in the companion sidecar file and the database.+No, Immich does not modify the original files.+All edited metadata is saved in companion `.xmp` sidecar files and the database.+However, Immich will delete original files that have been trashed when the trash is emptied in the Immich UI.### Can I add my existing photo library?@@ -162,6 +163,19 @@ We haven't implemented an official mechanism for creating albums from external lDuplicate checking only exists for upload libraries, using the file hash. Furthermore, duplicate checking is not global, but _per library_. Therefore, a situation where the same file appears twice in the timeline is possible, especially for external libraries.+### Why are my edits to files not being saved in read-only external libraries?++Images in read-write external libraries (the default) can be edited as normal.+In read-only libraries (`:ro` in the `docker-compose.yml`), Immich is unable to create the `.xmp` sidecar files to store edited file metadata.+For this reason, the metadata (timestamp, location, description, star rating, etc.) cannot be edited for files in read-only external libraries.++### How are deletions of files handled in external libraries?++Immich will attempt to delete original files that have been trashed when the trash is emptied.+In read-write external libraries (the default), Immich will delete the original file.+In read-only libraries (`:ro` in the `docker-compose.yml`), files can still be trashed in the UI.+However, when the trash is emptied, the files will re-appear in the main timeline since Immich is unable to delete the original file.+---## Machine Learning